Guides ยท Technology

API Pagination Design Basics

Choose and implement pagination patterns

This guide explains when to use offset vs cursor pagination, how to expose consistent parameters, return metadata, and provide examples to keep clients efficient and stable.

Select a strategy

Use cursor pagination for large or frequently changing data; offset for small, stable lists.

Expose clear params

Provide limit and page/cursor fields with sensible defaults and caps.

Return metadata

Include next/prev cursors or links, total counts when feasible, and ordering guarantees.

Document and test

Show code examples; test boundary cases like empty pages and deleted items.

Keep Exploring

Related Terms