> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beliefstate.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor pagination

> Follow cursors to retrieve complete result sets.

## 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 theme={null}
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 theme={null}
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.

*Last updated: 2026-09-26 · API version: v1 (Latest) · OpenAPI publication: 2026-09-13.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.