Paginate and version your integration

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:

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.

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

Last modified on August 22, 2026