Skip to main content
GET
/
v1
/
blocks
/
{block_id}
/
children
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.blocks.children.list({
  block_id: "c02fc1d3-db8b-45c5-a222-27595b15aea7",
  start_cursor: undefined,
  page_size: 50
})
{
  "type": "block",
  "block": {},
  "object": "list",
  "next_cursor": "<string>",
  "has_more": true,
  "results": [
    {
      "object": "block",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}
Page content is represented by block children. See the Working with page content guide for more information.
Returns only the first level of children for the specified block. See block objects for more detail on determining if that block has nested children. The response may contain fewer than page_size of results. See Pagination for details about how to use a cursor to iterate through the list.
Integration capabilitiesThis 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 block specified by id doesn’t exist, or if the integration 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

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2025-09-03.

Available options:
2025-09-03

Path Parameters

​
block_id
string
required

Query Parameters

​
start_cursor
string<uuid>
​
page_size
number

Response

​
type
enum<string>
required
Available options:
block
​
block
object
required
​
object
enum<string>
required
Available options:
list
​
next_cursor
string | null
required
​
has_more
boolean
required
​
results
(object | Paragraph · object | Heading 1 · object | Heading 2 · object | Heading 3 · object | Bulleted List Item · object | Numbered List Item · object | Quote · object | To Do · object | Toggle · object | Template · object | Synced Block · object | Child Page · object | Child Database · object | Equation · object | Code · object | Callout · object | Divider · object | Breadcrumb · object | Table Of Contents · object | Column List · object | Column · object | Link To Page · object | Table · object | Table Row · object | Embed · object | Bookmark · object | Image · object | Video · object | Pdf · object | File · object | Audio · object | Link Preview · object | Unsupported · object)[]
required