Notion API - Public Beta (English)
  1. Blocks
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
        DELETE
      • Append block children
        PATCH
      • Retrieve a block
        GET
      • Update a block
        PATCH
      • Retrieve block children
        GET
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments
  1. Blocks

Retrieve a block

GET
/v1/blocks/{id}
Blocks
Retrieve a block
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1/blocks/'
Response Response Example
{
  "created_time": "2021-08-06T17:46:00.000Z",
  "has_children": false,
  "id": "4868767d-9029-4b9d-a41b-652ef4c9c7b9",
  "last_edited_time": "2021-08-12T00:12:00.000Z",
  "object": "block",
  "paragraph": {
    "text": [
      {
        "annotations": {
          "bold": false,
          "code": false,
          "color": "default",
          "italic": false,
          "strikethrough": false,
          "underline": false
        },
        "href": null,
        "plain_text": "hello to you",
        "text": {
          "content": "hello to you",
          "link": null
        },
        "type": "text"
      }
    ]
  },
  "type": "paragraph"
}

Request

Path Params
id
string 
required

Responses

🟢200200 Success - Retrieve a block
application/json
Body
created_time
string 
optional
Example:
2021-08-06T17:46:00.000Z
has_children
boolean 
optional
Example:
false
id
string 
optional
Example:
4868767d-9029-4b9d-a41b-652ef4c9c7b9
last_edited_time
string 
optional
Example:
2021-08-12T00:12:00.000Z
object
string 
optional
Example:
block
paragraph
object 
optional
text
array [object {5}] 
optional
type
string 
optional
Example:
paragraph
Modified at 2023-04-27 10:02:23
Previous
Append block children
Next
Update a block
Built with