Docs menu

Common patterns

Pagination and filters

Resources use either offset pagination or an opaque cursor based on their access and ordering model.

Offset pagination

Workspaces, teams, members, invitations, roles, and export histories use offset and limit, with totals in page.total.

  • The first page starts with offset=0.
  • Request the next page with the previous offset + limit.
  • Concurrent changes may produce duplicates or gaps between pages.

Record cursor

Pass a returned next_token unchanged to the next records or shared-records request. A null value marks the last page.

Using filters

  • Send dates in ISO 8601 format.
  • Repeat the same key for array query parameters, for example team_ids=7&team_ids=8.
  • Use IDs returned by GET /labels in record label_ids filters.
Β© 2026 Return Zero, Inc.