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

# Paginate and version your integration

> Traverse collections with cursors and preserve API version compatibility.

Large collections use cursor pagination. Treat each cursor as an opaque value bound to the merchant, environment, and filters.

## Traverse a collection

Send `limit` and reuse `next_cursor` without changing it:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS "$SIMPLEPAY_API_BASE/v1/payment-operations/payments?limit=25" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY"
```

Stop when `has_more` is `false`. Do not reuse a cursor with another key, environment, or filter set.

## Preserve the version

Resources, errors, and events keep stable names within `v1`. An incompatible change requires a new version or a dated migration.