httpANYrestpaginationoffset
http
GET /users?page=2&limit=25Offset pagination is easy to understand, but performance can degrade on large datasets and results may shift during concurrent writes.
REST API Pagination, Filtering, Sorting, and Search
Common collection query patterns including offset pagination, cursor pagination, filtering, sorting, and search.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Pagination patterns
Use stable collection pagination contracts.
httpANYrestpaginationcursor
http
GET /events?limit=100&cursor=eyJpZCI6IjEwMDAifQ==Cursor pagination is often more stable and efficient than offset pagination for append-heavy lists.
jsonANYrestresponsemetadata
json
{
"data": [/* ... */],
"page": 2,
"limit": 25,
"total": 140,
"next_cursor": null
}Pagination metadata helps clients build pagers and infinite-scroll experiences without guessing.
httpANYrestcursorsorting
http
GET /events?sort=created_at:desc&cursor=...Cursor pagination works best when the ordering is explicit and stable.
Filtering, sorting, and search
Shape collection queries without inventing custom endpoints.
httpANYrestfilteringquery
http
GET /tickets?status=open&priority=highSimple query filtering is easy for clients and caches to understand.
httpANYrestsortingdesc
http
GET /tickets?sort=created_at:descA consistent sort syntax helps consumers avoid one-off endpoint conventions.
httpANYrestsortingmulti-field
http
GET /users?sort=last_name:asc,first_name:ascSecondary sort keys reduce unstable ordering when many rows share the same primary value.
httpANYrestsearchquery
http
GET /articles?q=rate%20limitingA simple `q` or `search` parameter is common for free-text search over selected fields.
httpANYrestdatesfiltering
http
GET /invoices?created_gte=2026-01-01T00:00:00Z&created_lt=2026-02-01T00:00:00ZExplicit lower and upper bounds are easier to reason about than vague relative date strings.
More in REST API
REST API Best Practices and Anti-Patterns
High-signal design rules, consistency patterns, and common mistakes to avoid in production APIs.
REST API Request and Response Patterns
JSON request bodies, envelope choices, sparse fieldsets, includes, concurrency control, and common response contracts.
REST API Authentication, Authorization, and Versioning
Bearer auth, API keys, permission errors, versioning strategies, and compatibility patterns for HTTP APIs.
REST API Status Codes and Error Response Design
Practical HTTP status codes, error response bodies, validation failures, and troubleshooting-friendly API error contracts.
REST API Resource Naming and URL Design
Naming conventions for resources, relationships, nested endpoints, and clean URL design.
REST API Methods and Idempotency
HTTP methods, safe vs unsafe semantics, and idempotency examples for API consumers and designers.