List APIs

Page through operational data without surprises.

Use limit and offset based pagination where list endpoints expose it, keep ordering stable, and design exports around repeatable windows.

Parameters

ParameterUse
limitMaximum number of records returned in the current page.
offsetNumber of records to skip before returning the next page.
totalTotal record count when the endpoint returns a paginated envelope.

Example

curl -sS "https://voice.stateset.app/api/v1/call-logs?limit=50&offset=100" \
  -H "Authorization: Bearer ${STATESET_VOICE_API_KEY}"

Stable export pattern

  1. Choose a page size that leaves headroom under rate limits.
  2. Read pages in order and checkpoint the last successful offset.
  3. For audit exports, capture the export start time and filter by a stable time window where available.
  4. Persist raw API responses before transformation so replay is possible.