Skip to main content
GET
TypeScript SDK
Retrieves one property on a page. The response is a property item or paginated list, depending on the type. Get the property ID from Retrieve a page or Retrieve a data source. Pass URL-encoded IDs as returned by the API.

Property item objects

Simple properties

Most types return one property_item object. This includes status, select, files, and multi_select. See Response shape by type.

Paginated properties

title, rich_text, people, and relation return a paginated list. Use this endpoint when a page response omits references. Continue with next_cursor until has_more is false. The next URL is nested at property_item.next_url. See Pagination fields and examples or Read every item in a page property.

Rollup properties

Rollups return a list with calculation metadata at property_item.rollup. Read every page before using a calculated result. See Rollup response rules and limits.

Errors

The connection needs read content capabilities. Missing capabilities return 403. A missing page or property, or missing access to the page, returns 404. Requests can also fail with a validation or rate-limit error. See Request limits.

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

The ID of the page containing the property.

property_id
string
required

The ID or name of the property to retrieve.

Query Parameters

start_cursor
string
page_size
integer

Response

type
string
required
Allowed value: "number"
number
number | null
required
object
string
required
Allowed value: "property_item"
id
string
required