Skip to content

Pagination and retained evidence

Use the continuation returned by the tool; different surfaces use different mechanisms.

Surface Continuation
Asset directory, market board, workflow help Returned next_offset with unchanged filters
Native metric series Returned next_cursor with the same series selection
Captured evidence arrays research_read_evidence and its returned next_offset
Cohort preparation Returned job ID and retry guidance—not a data-page cursor

Reading another page of captured evidence does not fetch missing upstream history. A new series request is needed for another upstream page or date window.

Cursors page through data that was already requested; an evidence reference points at a captured result with its own short lifetime; a refreshed read is a new request that may include source corrections. Keep the three apart when you retry or resume.

Do not concatenate overlapping pages into totals without checking their observation identities and units. Tool reference.