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

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.

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