Skip to main content
Paginated endpoints in the Sendcloud v3 API use cursor-based pagination with HTTP Link headers. Unlike offset-based pagination, cursor-based pagination provides stable results even when data changes between requests.

​
How it works

Pagination links (next, prev) are returned in the HTTP Link response header, not in the JSON response body. The response body only contains a data array.

​
Query parameters

When there are more pages available, the response includes a Link header with next and/or prev URLs:
The cursor values are base64-encoded and opaque. Do not parse or construct them manually — pass them back as-is from the Link header.

​
Example response

Response headers:
Response body:

​
Iterating through all pages

To retrieve all results, follow the next link from each response until no next link is returned:
  1. Make an initial request to the list endpoint (optionally with page_size).
  2. Parse the Link header from the response.
  3. If a rel="next" URL is present, make a request to that URL.
  4. Repeat until no next link is returned.