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
| Parameter | Use |
|---|---|
limit | Maximum number of records returned in the current page. |
offset | Number of records to skip before returning the next page. |
total | Total 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
- Choose a page size that leaves headroom under rate limits.
- Read pages in order and checkpoint the last successful offset.
- For audit exports, capture the export start time and filter by a stable time window where available.
- Persist raw API responses before transformation so replay is possible.