> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# blocks_children_list

> List the direct children of a block, or of a page when given a page ID. One level only: a child reporting `has_children` is read with another call using its own ID.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://api.notion.com/v1/blocks/{blockId}/children"}</code></div>

```python notion_blocks_children_list.py theme={null}
from charter.packs import notion

result = await notion.blocks_children_list.ainvoke({"blockId": ...})
```

<Note>
  Requires `Read content`. Pages by cursor: `next_cursor` is sent back as `start_cursor`.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                           | Type     | Description                                                                               |
  | --------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------- |
  | `blockId` <span className="required" title="required">\*</span> | `string` | The ID of the block, or of a page — a page is the block its top-level content hangs from. |
</div>

## Query parameters

<div className="reference-table">
  | Field         | Type      | Description                                                                                                                                                                                     |
  | ------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `startCursor` | `string`  | A `next_cursor` value returned in a previous response. Returns the results immediately after this cursor; omit it to start from the beginning.                                                  |
  | `pageSize`    | `integer` | The number of items from the full list desired in the response. Maximum 100, and 100 is also what the server returns when this is absent. <span className="field-constraints">≥ 1; ≤ 100</span> |
</div>