Blocks
Retrieve a block
Retrieves a Block object using the ID specified.
GET
TypeScript SDK
If the block returned contains the key
has_children: true, use the Retrieve block children endpoint to get the list of children.
To retrieve page content for a specific page, use Retrieve block children and set the page ID as the block_id.
For more information, read the Working with page content guide.
Connection capabilitiesThis endpoint requires a connection 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 connection capabilities, see the capabilities guide.
Errors
Returns a 404 HTTP response if the block doesn’t exist, or if the connection doesn’t have access to the block. 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.Authorizations
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Response
- Option 1
- Paragraph
- Heading 1
- Heading 2
- Heading 3
- Heading 4
- Bulleted List Item
- Numbered List Item
- Quote
- To Do
- Toggle
- Template
- Synced Block
- Child Page
- Child Database
- Equation
- Code
- Callout
- Divider
- Breadcrumb
- Table Of Contents
- Tab
- Column List
- Column
- Link To Page
- Table
- Table Row
- Meeting Notes
- Embed
- Bookmark
- Image
- Video
- Pdf
- File
- Audio
- Link Preview
- Unsupported