API Pagination & Filtering

When to Activate

• Adding pagination to a list endpoint (choosing offset vs cursor)
• Implementing filtering with operators (gte, lte, in, after)
• Designing multi-field sort parameters
• Adding full-text search or field-specific search
• Implementing sparse fieldsets (fields=id,name,email)
• Designing the next_cursor / has_next response envelope for infinite scroll

For REST URL design, HTTP methods, RFC 7807 errors, auth, rate limiting, and versioning — see skill api-design.

Pagination

Offset-Based (Simple)

GET /api/v1/users?page=2&per_page=20