> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [https://api.ken.so/v1/docs/openapi.json](https://api.ken.so/v1/docs/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Pagination

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

List endpoints return one page at a time and hand you a cursor for the next page.

## A page

```json
{
  "success": true,
  "data": [ { "id": 812 }, { "id": 815 } ],
  "pagination": { "nextCursor": "eyJpZCI6ODE1fQ", "hasMore": true }
}
```

## Parameters

| Parameter | What it does |
| --- | --- |
| `limit` | Items per page. Defaults to 50. Most lists accept up to 200 and answer `400` above that. Search lists return at most 100 per page. |
| `cursor` | The previous page's `pagination.nextCursor`. Leave it out for the first page. |

## Get the next page

Pass the previous page's `nextCursor` as `cursor`, with the same filters:

```bash
curl "https://api.ken.so/v1/campaigns?limit=100&cursor=eyJpZCI6ODE1fQ" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

- Stop when `hasMore` is `false`.
- Cursors are opaque strings. Pass them back as they came, without building or editing them.

## Totals

Some lists also return `pagination.total`: the number of items that match the list's filters, across all pages. A list that does not count its items leaves `total` out.

```json
"pagination": { "nextCursor": "eyJpZCI6ODE1fQ", "hasMore": true, "total": 1000, "isTotalCapped": true }
```

- `isTotalCapped: true` means `total` stopped counting at its cap: more items match than it says. Show it as a lower bound, such as 1,000+, and keep paging while `hasMore` is `true`.
- When `total` is exact, `isTotalCapped` is left out.
- Page with `hasMore`, never by counting up to `total`: items can be added or removed while you page.

## More guides

- [Authentication](/docs/authentication.md)
- [Workspaces](/docs/workspaces.md)
- [Versioning](/docs/versioning.md)
- [Errors](/docs/errors.md)
- [Rate limits](/docs/rate-limits.md)
- [Idempotency](/docs/idempotency.md)
- [Webhooks](/docs/webhooks.md)
- [Changelog](/docs/changelog.md)
- [API reference](/docs.md)
