What is Pagination?

Pagination is the technique of breaking large result sets into discrete chunks or pages returned over successive API requests.

How it works

Common patterns include offset-limit pagination (?offset=20&limit=10) and cursor-based pagination (?starting_after=obj_123). Cursor-based pagination is preferred for high-frequency or real-time collections.

Common mistakes

  • Returning unbounded arrays on GET collection endpoints
  • Using offset pagination on tables with high write volume