property_item object for a given
property_id. Depending on the property type, the object returned will either be a value or a paginated list of property item values. See Property item objects for specifics.
property_id's, use the Retrieve a database endpoint.
In cases where a property item has more than 25 references, this endpoint should be used, rather than Retrieve a page. (Retrieve a page will not return a complete list when the list exceeds 25 references.)
For more detailed information refer to the Property item object documentation
property_item properties will have a
type and under the the key with the value for
type, an object that identifies the property value, documented under Property value objects.
Property types that return a paginated list of property item objects are:
Look for the
next_url value in the response object for these property items to view paginated results. Refer to paginated page properties for a full description of the response object for these properties.
Refer to the pagination reference for details on how to iterate through a results list.
For regular "Show original" rollups, the endpoint returns a flattened list of all the property items in the rollup.
For rollups with an aggregation, the API returns a rollup property value under the
rollup key and the list of relations.
In order to avoid timeouts, if the rollup has a with a large number of aggregations or properties the endpoint returns a
next_cursor value that is used to determinate the aggregation value so far for the subset of relations that have been paginated through.
false, then the final rollup value is returned. Refer to the Pagination documentation for more information on pagination in the Notion API.
Computing the values of following aggregations are not supported. Instead the endpoint returns a list of
property_item objects for the rollup:
show_unique(Show unique values)
unique(Count unique values)
This endpoint requires an integration to have read content capabilities. Attempting to call this API without read content capabilities will return an HTTP response with a 403 status code. For more information on integration capabilities, see the capabilities guide.
Returns a 404 HTTP response if the page or property doesn't exist, or if the integration doesn't have access to the page.
Returns a 400 or 429 HTTP response if the request exceeds the request limits.
Note: Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.