Pagination
Some list endpoints return paginated results. Stables uses cursor-based pagination, with two styles depending on the endpoint group.
Pagination parameter names vary by endpoint group. Always refer to the individual endpoint's API reference for the exact query parameter and response field names.
Page tokens
Used by List Transfers, List Customers and the balance lists (/api/v1/prefund/activity, /api/v1/prefund/whitelisted-wallets).
Query Parameters
| Parameter | Type | Description |
|---|---|---|
page_size | integer | Maximum number of records to return (1 to 100) |
page_token | string | Opaque token from the previous response's next_page_token |
Pagination Fields in Response
| Endpoint group | Next token | Also returned | Last page |
|---|---|---|---|
| Transfers, Customers | page.next_page_token | page.total | next_page_token is empty |
| Balances | next_page_token | has_more | has_more is false |
On List Customers, page is only returned when you pass page_size. Without it, every customer is returned in one response.
Starting after an id
Used by the virtual account lists and virtual account history.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit | integer | Maximum number of records to return (1 to 100, default 10) |
starting_after | string | Cursor: the id of the last item from the previous page |
ending_before | string | Cursor: the id of the first item from the previous page |
Pagination Fields in Response
| Endpoint | Fields |
|---|---|
| List Virtual Accounts | data, and count (the total number of matching virtual accounts) |
| Virtual account history | data, and has_more (whether more results exist) |
Example
GET /api/v1/customers/{customerId}/virtual-accounts?limit=20&starting_after=550e8400-e29b-41d4-a716-446655440000Other lists
- List RFIs takes
limit(default 50) andcursor, and returnsnext_cursor, which is absent on the last page. - List webhook deliveries takes
pageSizeandpageToken, and returnspage.nextPageToken, which is empty on the last page.