Pagination
Working with paginated API responses
Overview
All list endpoints support pagination using limit and offset parameters.
Parameters
limitintegerquerydefault: 50Maximum results per page (max: 100)
offsetintegerquerydefault: 0Number of results to skip
Example
bash
GET /api/v1/leads?limit=50&offset=100Response 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