Core concepts

Pagination

Cursor pagination over list endpoints.

How it works

List endpoints return the shared envelope { data, total, cursor? }. Where supported, control page size with ?limit= and continue with the opaque ?cursor= returned by the previous page. When cursor is absent or null, you have reached the end.

Cursors are opaque

Never parse or construct a cursor; treat it as a token and pass it back verbatim.

Example

curl

# First page
curl "https://www.opencharts.com/api/v1/conversations?limit=20" \
  -H "Authorization: Bearer $OPENCHARTS_API_KEY"

# Next page (cursor from the previous response)
curl "https://www.opencharts.com/api/v1/conversations?limit=20&cursor=CURSOR" \
  -H "Authorization: Bearer $OPENCHARTS_API_KEY"