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

Have your agent know this before it fails

claude mcp add --transport http footgun https://getfootgun.com/api/mcp