Pagination

Two pagination styles are in use across the API: cursor-based and page-based.

Two pagination styles are in use, depending on the endpoint.

Cursor-based

Used by endpoints that return a cursor pagination envelope.

{
  "data": {
    "items": [],
    "pagination": { "cursor": null, "next_cursor": "abc123", "has_more": true }
  }
}

To fetch the next page, send the previous next_cursor value as the cursor field in the next request body.

Page-based

Used by /contacts/employee-finder.

{
  "data": {
    "items": [],
    "pagination": { "page": 1, "per_page": 25, "total": 142, "has_more": true, "next_page": 2 }
  }
}

Send the next_page value as page in the next request body.

Non-paginated endpoints

Endpoints that return a top-level array (/discover/companies, /contacts/find, /signals/*) are not paginated. Use max_results (or the per-endpoint equivalent) to control the page size.