Notion API · api · fg-0460
Notion page response shows only 25 relations or people even though the property holds more
Relation array stops at 25 entries
Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100
Cause
Page and query responses include at most 25 references for relation and people properties and at most 25 mentions in title or rich text. Formulas also evaluate only the first 25 relation references.
Fix
Read the full value through the page property item endpoint and page through every result.
Apply
let cursor; const ids = [];
do {
const r = await notion.pages.properties.retrieve({ page_id, property_id, start_cursor: cursor });
ids.push(...r.results.map(x => x.relation.id));
cursor = r.next_cursor ?? undefined;
} while (cursor);Affects: Notion REST API, all versions, as of 2026-10
Sources
- https://developers.notion.com/reference/retrieve-a-page
- https://developers.notion.com/reference/query-a-data-source
Have your agent know this before it fails
claude mcp add --transport http footgun https://getfootgun.com/api/mcp