Skip to content
Developer portal

Pagination

Lists are paged by cursor and ordered by id:

{ "object": "list", "data": [ ... ], "has_more": true, "next_cursor": "cGlfMDFK..." }

Ask for up to limit objects (1 to 100, 10 by default). When has_more is true, pass next_cursor back as cursor for the next page. A cursor is opaque: do not read or build one. Objects added or removed meanwhile never shift a later page.

Terminal window
curl "https://api.example.com/v1/payment_intents?limit=2" \
  -H "Authorization: Bearer $ACCESS_TOKEN"


curl "https://api.example.com/v1/payment_intents?limit=2&cursor=cGlfMDFK..." \
  -H "Authorization: Bearer $ACCESS_TOKEN"

A limit outside 1 to 100, or a cursor that is not a next_cursor from an earlier page, is refused with validation_failure, and param says which.