Blocks

Retrieve a block

Changed on
get/v1/blocks/{block_id}

Request

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

Path parameters

block_idstring required

Headers

Notion-Version'2026-03-11' required

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

Response

OR

Example response

{
  "paragraph": {
    "rich_text": [
      {
        "text": {
          "link": {
            "url": "https://www.notion.com"
          }
        }
      }
    ],
    "icon": {
      "emoji": "😀"
    }
  }
}

Changes

    • info

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

    • info

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

    • warning

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