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

# Pagination

> Traverse large resources safely.

List endpoints may return pagination metadata when the resource supports it.

Use `limit` and cursor/page parameters documented on each endpoint. Keep page sizes bounded for agent workflows.

```bash theme={null}
firstsales contacts list --org org_123 --workspace ws_123 --json
```

Agent clients should:

* Read one page.
* Decide whether the next page is necessary.
* Stop when the task has enough evidence.
* Avoid fetching every contact or event unless the workflow explicitly needs a full export.