Pages
Retrieve a page property item
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 oneproperty_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 atproperty_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 return403. 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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Path Parameters
The ID of the page containing the property.
The ID or name of the property to retrieve.
Response
- 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