Pagination

Every list endpoint in the v2 API returns the same envelope:

{
  "items": [ ... ],
  "start": 0,
  "limit": 25
}

• items - the page of results.
• start - the zero-based offset of the first item, echoing the start query parameter (default 0).
• limit - the page size, echoing the limit query parameter (default 25, clamped to 100).

The envelope carries no total. When you need one, use the list’s /count companion endpoint (for example Count contacts next to List contacts), which accepts the same filters and returns { "count": n }.

A few short lists - account members, your own accounts, your own tokens - always return the full result in a single envelope: they take no start/limit parameters and have no /count companion. Each endpoint’s reference page shows which query parameters it accepts.

Walking the pages

Request pages by advancing start by limit until a page comes back with fewer than limit items:

curl --location 'https://api.sendstreak.com/v2/accounts/YOUR_ACCOUNT_ID/contacts?start=50&limit=25' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Asking for a limit above 100 does not fail - the API clamps the page size to 100, so check the echoed limit field rather than assuming the requested size.