REST API Pagination, Filtering, Sorting, and Search

GET /users?page=2&limit=25

# Simple page and limit contract.

GET /events?limit=100&cursor=eyJpZCI6IjEwMDAifQ==

# Use opaque cursors for large or changing datasets.

{
  "data": [/* ... */],
  "page": 2,
  "limit": 25,
  "total": 140,
  "next_cursor": null
}

# Expose pagination state in the response body.

GET /events?sort=created_at:desc&cursor=...

# Paginate in a deterministic order.

GET /tickets?status=open&priority=high

# Restrict a collection by one or more fields.

GET /tickets?sort=created_at:desc

# Ask for newest records first.

GET /users?sort=last_name:asc,first_name:asc

# Provide fallback ordering.

GET /articles?q=rate%20limiting

# Search collection text with a query term.

GET /invoices?created_gte=2026-01-01T00:00:00Z&created_lt=2026-02-01T00:00:00Z

# Use ISO timestamps for time-based queries.