Notion API - Public Beta (English)
  1. Pages
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • 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
        GET
      • Create a page
        POST
      • Retrieve a Page
        GET
      • Update Page properties
        PATCH
    • 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. Pages

Retrieve a Page

GET
/v1/pages/{id}
Pages
Retrieves a Page object using the ID in the request path. This endpoint exposes page properties, not page content.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1/pages/'
Response Response Example
{
  "archived": false,
  "created_time": "2021-04-27T20:38:19.437Z",
  "id": "a1712d54-53e4-4893-a69d-4d581cd2c845",
  "last_edited_time": "2021-04-27T20:38:19.437Z",
  "object": "page",
  "parent": {
    "database_id": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae",
    "type": "database_id"
  },
  "properties": {
    "Author": {
      "id": "qNw_",
      "multi_select": [
        {
          "color": "default",
          "id": "833e2c78-35ed-4601-badc-50c323341d76",
          "name": "Kara Swisher"
        }
      ],
      "type": "multi_select"
    },
    "Link": {
      "id": "VVMi",
      "type": "url",
      "url": "https://www.nytimes.com/2018/10/21/opinion/who-will-teach-silicon-valley-to-be-ethical.html"
    },
    "Name": {
      "id": "title",
      "title": [
        {
          "annotations": {
            "bold": false,
            "code": false,
            "color": "default",
            "italic": false,
            "strikethrough": false,
            "underline": false
          },
          "href": null,
          "plain_text": "Who Will Teach Silicon Valley to Be Ethical? ",
          "text": {
            "content": "Who Will Teach Silicon Valley to Be Ethical? ",
            "link": null
          },
          "type": "text"
        }
      ],
      "type": "title"
    },
    "Publisher": {
      "id": ">$Pb",
      "select": {
        "color": "default",
        "id": "c5ee409a-f307-4176-99ee-6e424fa89afa",
        "name": "NYT"
      },
      "type": "select"
    },
    "Publishing/Release Date": {
      "date": {
        "end": null,
        "start": "2018-10-21"
      },
      "id": "?ex+",
      "type": "date"
    },
    "Read": {
      "checkbox": false,
      "id": "_MWJ",
      "type": "checkbox"
    },
    "Status": {
      "id": "`zz5",
      "select": {
        "color": "yellow",
        "id": "8c4a056e-6709-4dd1-ba58-d34d9480855a",
        "name": "Ready to Start"
      },
      "type": "select"
    },
    "Summary": {
      "id": "?\\25",
      "text": [
        {
          "annotations": {
            "bold": false,
            "code": false,
            "color": "default",
            "italic": false,
            "strikethrough": false,
            "underline": false
          },
          "href": null,
          "plain_text": "Some think chief ethics officers could help technology companies navigate political and social questions.",
          "text": {
            "content": "Some think chief ethics officers could help technology companies navigate political and social questions.",
            "link": null
          },
          "type": "text"
        }
      ],
      "type": "text"
    },
    "Type": {
      "id": "/7eo",
      "select": {
        "color": "default",
        "id": "f96d0d0a-5564-4a20-ab15-5f040d49759e",
        "name": "Article"
      },
      "type": "select"
    }
  }
}

Request

Path Params
id
string 
required

Responses

🟢200200 Success - Retrieve a Page
application/json
Body
archived
boolean 
optional
Example:
false
created_time
string 
optional
Example:
2021-04-27T20:38:19.437Z
id
string 
optional
Example:
a1712d54-53e4-4893-a69d-4d581cd2c845
last_edited_time
string 
optional
Example:
2021-04-27T20:38:19.437Z
object
string 
optional
Example:
page
parent
object 
optional
database_id
string 
optional
Example:
8e2c2b76-9e1d-47d2-87b9-ed3035d607ae
type
string 
optional
Example:
database_id
properties
object 
optional
Author
object 
optional
Link
object 
optional
Name
object 
optional
Publisher
object 
optional
Publishing/Release Date
object 
optional
Read
object 
optional
Status
object 
optional
Summary
object 
optional
Type
object 
optional
Modified at 2023-04-27 10:02:23
Previous
Create a page
Next
Update Page properties
Built with