# Pagination

Read complete paginated results

> Section: Guides

> Last updated: **2026-09-26**.

> API version: **v1 (Latest)**. OpenAPI publication: **2026-11-08**.

## Request the first page

Set BELIEFSTATE_TICKER to the requested symbol from released coverage. Set a bounded limit and omit cursor on the first request. Set BELIEFSTATE_REQUEST_ID to a new UUID for each page; reuse it only when retrying the exact same request.

```bash
curl --fail-with-body \
  --header "Authorization: Bearer $BELIEFSTATE_API_KEY" \
  --header "X-Request-ID: ${BELIEFSTATE_REQUEST_ID:?Set a new UUID for this request; keep it for retries}" \
  "https://beliefstate.ai/v1/beliefs?ticker=${BELIEFSTATE_TICKER:?Set the requested ticker from current coverage}&limit=10"
```

Store the response `as_of`, `pagination.next_cursor`, and `pagination.next_page_url`.

## Continue

When pagination.next_page_url is present, request that exact URL with a new request ID. Stop when it is null. Keep the ID unchanged only when retrying the same page.

```bash
curl --fail-with-body \
  --header "Authorization: Bearer $BELIEFSTATE_API_KEY" \
  --header "X-Request-ID: ${BELIEFSTATE_REQUEST_ID:?Set a new UUID for this page; keep it for retries}" \
  "${BELIEFSTATE_NEXT_PAGE_URL:?Set pagination.next_page_url from the previous response}"
```

The URL carries the cursor and original filters. Do not decode or edit it.

## Keep time stable

Reuse the response as_of value on every later page so newly observed evidence cannot enter the middle of the result set.

> A page cursor controls position. The as_of cutoff controls which evidence is eligible. Preserve both. Restart from the first page when the logical query changes.

## Agent feedback

Report unclear, stale, or incorrect documentation through [BeliefState support](https://beliefstate.ai/contact). Include this page URL and the smallest reproducible detail.

<!-- BeliefState-Origin: https://beliefstate.ai/docs/guides/pagination; Content-Fingerprint: bs-sha256-6ae014bec0e633af615eecc9a4752ab3359bbe8efc6c0f539f58b604fdf30435 -->
