Retrieves a Page object using the ID specified.

📘

Responses contains page properties, not page content. To fetch page content, use the retrieve block children endpoint.

Limits

The endpoint returns a maximum of 25 page or person references per page property. If a page property includes more than 25 references, then the 26th reference and beyond might be returned as Untitled, Anonymous, or not be returned at all.

This limit affects the following properties:

  • people: response object can’t be guaranteed to return more than 25 people.
  • relation: the has_more value of the relation in the response object is true if a relation contains more than 25 related pages. Otherwise, has_more is false.
  • rich_text: response object includes a maximum of 25 populated inline page or person mentions.
  • title: response object includes a maximum of 25 inline page or person mentions.

👍

A workaround for properties with more than 25 references

If a page property includes more than 25 references, then you can use the Retrieve a page property endpoint for the specific property to get its complete list of references.

📘

Integration capabilities

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.

Errors

Returns a 404 HTTP response if the page 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.

Language