Skip to main content
List endpoints return one page at a time in the same envelope:
Single objects (for example GET /v1/creators/{creatorId}) are returned bare, without an envelope.

Parameters

Cursors are opaque. Pass them back exactly as you received them; never build or edit one. Keep every other parameter (filters, sort) identical while you page: a cursor belongs to one query. A malformed cursor returns 400 VALIDATION_ERROR. Cursors are for paging through a result now, not for storing and resuming days later.

Page sizes

Walk every page

Message history pages backwards

Messages are different: a chat is read from the newest end.
  • GET /v1/conversations/{conversationId}/messages without before returns the newest page.
  • Each page is ordered oldest to newest.
  • To get older messages, pass before = the id of the first (oldest) message on the page you have.
  • hasMore: false means you reached the beginning of the conversation.
A complete example is in Read and send messages.

Consistency

Lists reflect live data. Items created while you page may appear on a later page or not at all, and an item that changes (for example a conversation that gets a new message while you page conversations sorted by recent) can move between pages. When you need an exact snapshot, page quickly and de-duplicate by id.