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.
For more detailed information see 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:
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. See 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.