Skip to Content

Pagination

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

Ken-Version: 2026-11-02
Markdown

A page

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

Parameters

ParameterWhat it does
limitItems per page. Defaults to 50. Most lists accept up to 200 and answer 400 above that. Search lists return at most 100 per page.
cursorThe 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:

Request
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

On this page