Pagination | Orwel Docs
Docs

Pagination

Working with paginated API responses

Overview

All list endpoints support pagination using limit and offset parameters.

Parameters

limitintegerquerydefault: 50

Maximum results per page (max: 100)

offsetintegerquerydefault: 0

Number of results to skip

Example

bash
GET /api/v1/leads?limit=50&offset=100

Response Format

json
{
  "data": [...],
  "pagination": {
    "limit": 50,
    "offset": 100,
    "total": 500
  }
}

Best Practices

  • Use reasonable page sizes (50-100 items)
  • Cache results when possible
  • Implement cursor-based pagination for large datasets