Retrieve a page property item

GET /v1/pages/{page_id}/properties/{property_id}

TypeScript SDK

JavaScript

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.pages.properties.retrieve({
  page_id: "b55c9c91-384d-452b-81db-d1ef79372b75",
  property_id: "aBcD"
})

200

{
  "type": "<string>",
  "number": 123,
  "object": "<string>",
  "id": "<string>"
}

Retrieves a property_item object for a given page_id and property_id. Depending on the property type, the object returned will either be a value or a paginated list of property item values. See Property item objects for specifics.

To obtain property_ids, use the Retrieve a database endpoint.

In cases where a property item has more than 25 references, this endpoint should be used, rather than Retrieve a page. (Retrieve a page will not return a complete list when the list exceeds 25 references.)

Property Item Objects

For more detailed information refer to the Property item object documentation

Simple Properties

Each individual property_item properties will have a type and under the the key with the value for type, an object that identifies the property value, documented under Page property values.

Paginated Properties

Property types that return a paginated list of property item objects are:

• title
• rich_text
• relation
• people

Look for the next_url value in the response object for these property items to view paginated results. Refer to paginated page properties for a full description of the response object for these properties.

Refer to the pagination reference for details on how to iterate through a results list.

Rollup Properties

Learn more about rollup properties on the Page properties page or in Notion’s Help Center.

For regular “Show original” rollups, the endpoint returns a flattened list of all the property items in the rollup.

For rollups with an aggregation, the API returns a rollup property value under the rollup key and the list of relations.

In order to avoid timeouts, if the rollup has a with a large number of aggregations or properties the endpoint returns a next_cursor value that is used to determinate the aggregation value so far for the subset of relations that have been paginated through.

Once has_more is false, then the final rollup value is returned. Refer to the Pagination documentation for more information on pagination in the Notion API.

Computing the values of following aggregations are not supported. Instead the endpoint returns a list of property_item objects for the rollup:

• show_unique (Show unique values)
• unique (Count unique values)
• median(Median)

Connection capabilities

This endpoint requires a connection to have read content capabilities. Attempting to call this API without read content capabilities will return an HTTP response with a 403 status code. For more information on connection capabilities, see the capabilities guide.

Errors

Returns a 404 HTTP response if the page or property doesn’t exist, or if the connection doesn’t have access to the page.

Returns a 400 or 429 HTTP response if the request exceeds the request limits.

Note: Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version · enum<string> · required

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

Available options: 2026-03-11

Path Parameters

page_id · string · required

property_id · string · required

Query Parameters

start_cursor · string

page_size · integer

Response

200

application/json

Number

Url

Select

Multi Select

Status

Date

Email

Phone Number

Checkbox

Files

Created By

Created Time

Last Edited By

Last Edited Time

Formula

Button

Unique Id

Verification

Place

Title

Rich Text

People

Relation

Rollup

Property Item

type · string · required

Allowed value: "number"

number · number | null · required

object · string · required

Allowed value: "property_item"

id · string · required