Pagination - Tickable API

All list endpoints return paginated responses with a consistent format.

Response 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

Each endpoint supports specific sort fields — refer to the API reference for details.

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'
});

import requests

def fetch_all(url, headers):
    results = []
    offset = 0
    limit = 100

    while True:
        response = requests.get(url, headers=headers, params={
            'limit': limit,
            'offset': offset
        })
        body = response.json()
        results.extend(body['data'])

        if not body['pagination']['has_more']:
            break
        offset += limit

    return results

events = fetch_all('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.