Skip to main content

Pagination

All top-level collection endpoints (such as GET /api/v1/calls, GET /api/v1/agents, and GET /api/v1/campaigns) return paginated results using cursor-based pagination. Cursor pagination provides consistent performance and eliminates duplicate or missing items during active inserts.

Query Parameters


Standard Response Structure

Every list response wraps item arrays inside a standard paginated envelope:

Response Fields

  • data: Array containing the requested resource objects.
  • has_more: A boolean flag. Set to true if more records exist beyond the current page; otherwise false.
  • next_cursor: The cursor ID of the last element in data. Pass this as starting_after on your subsequent request.
  • total_count: Total number of matching elements across the entire collection.

Code Example: Iterating Through All Pages

Python Example

TypeScript / Node.js Example