Notion API · api · fg-0461

Notion query or list call returns exactly 100 results and the rest are missing

results.length is 100 and has_more is true

Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100

Cause

List and query endpoints return at most 100 items per call and expect next_cursor to be passed back as start_cursor. Code that reads one response only ever sees the first page.

Fix

Loop on has_more and next_cursor, or use the SDK pagination helpers.

Apply

import { collectPaginatedAPI } from "@notionhq/client";
const blocks = await collectPaginatedAPI(notion.blocks.children.list, { block_id: pageId });

Affects: Notion REST API, all list and query endpoints, as of 2026-10

Sources

Have your agent know this before it fails

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