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.