API reference: Pagination

Pagination. Cursors that stay correct while data changes.

Lists return the newest items first, a page at a time. Follow nextCursor until hasMore is false.

Page 120 conversations
nextCursor: MjAyNi0…
Page 220 conversations
nextCursor: MjAyNi0…
Page 37 conversations
hasMore: false

By , AI EngineerUpdated

How it works

  • Ask for up to 100 items with ?limit= (default 20).
  • The response's meta.pagination has limit, hasMore and nextCursor.
  • While hasMore is true, request the next page with ?cursor=<nextCursor>, keeping your other query parameters.
"meta": {
  "requestId": "req_…",
  "pagination": { "limit": 20, "hasMore": true, "nextCursor": "MjAyNi0xMC0wN1QwOToz…" }
}
curl https://get-api.simplyboost.io/api/v1/chatbots/CHATBOT_ID/conversations?limit=50&cursor=MjAyNi0xMC0wN1QwOToz… \
  -H "Authorization: Bearer $SIMPLYBOOST_TOKEN"

Why cursors

A cursor points at the last item you received, not at a page number. New conversations or leads arriving while you page do not shift items between pages, so you never see one twice or miss one. Treat the cursor as opaque: do not build or change it. A cursor that is not valid returns 400 validation_error.

Try SimplyBoost with your own content

Start a 7-day free trial with 100 AI replies. Add your website, install the widget and see how the agent answers your customers. Larger team? Custom plans above 4,000 AI replies come with a dedicated account manager and white-label.

See pricing
  • 7 days, 100 AI replies
  • From €39 a month
  • Hosted in Europe