> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Handle paginated collections and stateful result iterators.

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`.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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.