Blocks

Retrieve block children

Changed on
get/v1/blocks/{block_id}/children

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/blocks/{block_id}/children
  • Auth
    HTTP bearer

Path parameters

block_idstring required

Query parameters

start_cursorstring uuid
page_sizenumber

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

type'block' required
blockEmptyObject required
object'list' required
next_cursorstring nullable required
has_moreboolean required

Changes

  • 8967a2a7b255Revision changes
    • info

      added the optional property ///////// to the response with the status

    • info

      added the required property //////// to the response with the status

  • c90a4587bc95Revision changes
    • warning

      added the new idempotency_key_reused enum value to the / response property for the response status