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

# Pagination

> Cursor-based pagination for list endpoints.

List endpoints (`GET /v1/people`, `GET /v1/companies`, …) return a cursor-paginated envelope:

```json theme={null}
{
  "data": [ /* up to `limit` records */ ],
  "nextCursor": "01JABCDEF..."
}
```

When `nextCursor` is `null`, you have reached the end. Otherwise, pass it back as the `cursor` query parameter to fetch the next page:

```bash theme={null}
curl "https://thanos.notealy.com/v1/people?limit=100&cursor=01JABCDEF..." \
  -H "Authorization: Bearer sk_live_..."
```

## Parameters

| Parameter | Default  | Notes                                                          |
| --------- | -------- | -------------------------------------------------------------- |
| `limit`   | `50`     | Max page size — see the API reference for the per-resource cap |
| `cursor`  | *(none)* | Opaque value from the previous response's `nextCursor`         |

Records are ordered by creation time, newest first. The cursor encodes the last id of the previous page; do not parse or generate it yourself.

## Idempotency note

Cursor pagination is stable as long as the underlying records are not deleted between page fetches. If a record at the cursor boundary is deleted, the next page request will fall back to the next valid record — you may miss the deleted one but never see duplicates.