Blocks

Retrieve block children

get/v1/blocks/{block_id}/children

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

Changed in 5 of the 17 revisions of this API.191

    • added the new idempotency_key_reused enum value to the allOf[subschema #2]/code response property for the response status 409

      response-property-enum-value-added

  • ae20477af71b11See the full diff
    • added subschema #1 subschema #2 subschema #3 to the response body oneOf list for the response status 403

      response-body-one-of-added

    • removed publicApiCommonErrorResponse subschema #2 from the response body allOf list for the response status 403

      response-body-all-of-removed

    • added the new agent_credit_limit_reached enum value to the allOf[subschema #2]/code response property for the response status 403

      response-property-enum-value-added

    • added the new workspace_credits_exhausted enum value to the allOf[subschema #2]/code response property for the response status 403

      response-property-enum-value-added

    • added the new invalid_beta enum value to the allOf[subschema #2]/code response property for the response status 400

      response-property-enum-value-added

    • added the new invalid_credit_limit enum value to the allOf[subschema #2]/code response property for the response status 400

      response-property-enum-value-added

    • added the new agent_deleted enum value to the allOf[subschema #2]/code response property for the response status 409

      response-property-enum-value-added

    • added the new directory_not_found enum value to the allOf[subschema #2]/code response property for the response status 404

      response-property-enum-value-added

    • added the new status_change_not_allowed enum value to the allOf[subschema #2]/code response property for the response status 403

      response-property-enum-value-added

    • added the new transcription_failed enum value to the results/items/anyOf[blockObjectResponse]/anyOf[subschema #27: Meeting Notes]/meeting_notes/status response property for the response status 200

      response-property-enum-value-added