Skip to main content
The Clay Public API uses two response patterns for multi-item endpoints.

​
Cursor pagination

Stable collection endpoints return data and, when another page is available, cursor. 
{
  "data": [],
  "cursor": "next_page_token"
}
Send the returned cursor on the next request. If cursor is omitted, there are no more pages.

​
Stateful iterators

Some endpoints consume state as they return results. These responses return data and has_more instead of a cursor. 
{
  "data": [],
  "has_more": true
}
Call the endpoint again while has_more is true.

​
Limits

Endpoints that accept limit default to a safe page size. Use smaller page sizes when you need lower latency and larger page sizes when you want fewer round trips.