All list endpoints return paginated responses with a consistent format.
{
"data": [...],
"pagination": {
"total": 142,
"limit": 25,
"offset": 0,
"has_more": true
}
}
| Field | Description |
|---|
total | Total number of results matching your query |
limit | Number of results per page |
offset | Number of results skipped |
has_more | Whether there are more results after this page |
Query Parameters
| Parameter | Default | Max | Description |
|---|
limit | 25 | 100 | Number of results per page |
offset | 0 | - | Number of results to skip |
sort | created_at:desc | - | Sort field and direction |
Sorting
Use the sort parameter with the format field:direction:
# Newest first (default)
GET /events?sort=created_at:desc
# Alphabetical by title
GET /events?sort=title:asc
Paginating Through All Results
async function fetchAll(url, headers) {
const results = [];
let offset = 0;
const limit = 100;
while (true) {
const response = await fetch(`${url}?limit=${limit}&offset=${offset}`, { headers });
const { data, pagination } = await response.json();
results.push(...data);
if (!pagination.has_more) break;
offset += limit;
}
return results;
}
const events = await fetchAll('https://api.tickable.io/events', {
'Authorization': 'Bearer tk_live_YOUR_API_KEY'
});
Use the maximum limit=100 when fetching all results to minimize the number of API calls.