Skip to main content
Every list endpoint in v2 returns the same envelope:
There are no offsets and no totals. To fetch the next page, pass nextCursor back as ?cursor=….

Fields

array
required
Items on this page, newest first.
boolean
required
true when a next page exists. When false, nextCursor is null.
string | null
required
Opaque cursor for the next page. null on the last page. Do not parse or construct cursors yourself — they are only meaningful to the server that issued them.

Page size

List endpoints accept an optional limit query parameter. Defaults and maximums are documented per endpoint; a common default is 20 and a common ceiling is 100. If you send a value outside the allowed range you’ll get a 400 parameter_invalid.

Example

A minimal loop that reads every item:
Cursors are stable — the same cursor always returns the same next page. Two callers paging the same list will see the same items in the same order.