Pagination
List endpoints return one page at a time and hand you a cursor for the next page.
A page
{
"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:
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
hasMoreisfalse. - 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.
"pagination": { "nextCursor": "eyJpZCI6ODE1fQ", "hasMore": true, "total": 1000, "isTotalCapped": true }isTotalCapped: truemeanstotalstopped counting at its cap: more items match than it says. Show it as a lower bound, such as 1,000+, and keep paging whilehasMoreistrue.- When
totalis exact,isTotalCappedis left out. - Page with
hasMore, never by counting up tototal: items can be added or removed while you page.
More guides
AuthenticationWorkspacesVersioningErrorsRate limitsIdempotencyWebhooksChangelogAPI reference