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
Previous
Create a page
Next
Update Page properties
Built with