List events | TTG Developer Portal

curl -G https://stg.ttix.io/api/v3/events \
     -H "X-TT-Retailer: YOUR_RETAILER_ID" \
     -H "X-TT-Platform: android" \
     -H "X-TT-API-Key: <apiKey>" \
     -d locationId=1 \
     -d query=hamilton \
     -d limit=50 \
     -d offset=0

{
  "data": [
    {
      "id": "456",
      "name": "Hamilton",
      "orderLimit": {
        "max": 8,
        "min": 1
      },
      "productType": "SHOW",
      "endDate": "2026-12-31",
      "fromPrice": {
        "amount": 8900,
        "currency": "USD"
      },
      "location": {
        "id": "1",
        "name": "New York",
        "country": "US",
        "slug": "nyc"
      },
      "maxDiscountPercentage": 25,
      "slug": "hamilton-broadway",
      "startDate": "2026-03-01"
    },
    {
      "id": "457",
      "name": "The Phantom of the Opera",
      "orderLimit": {
        "max": 6,
        "min": 1
      },
      "productType": "SHOW",
      "endDate": null,
      "fromPrice": {
        "amount": 3500,
        "currency": "GBP"
      },
      "location": {
        "id": "2",
        "name": "London",
        "country": "GB",
        "slug": "london"
      },
      "slug": "the-phantom-of-the-opera",
      "startDate": "2026-05-15"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 2
  }
}

Returns a paginated list of events in a location. Pass query to narrow the list to events matching a search term.

Authentication

X-TT-API-Keystring

API Key authentication via header

Query parameters

locationIdstringRequiredformat: "^[1-9]\d*$">=1 character

Location ID to filter events by

querystringOptional0-50 characters

Free-text search across event name, venue, category, cast and search keywords. Combines with locationId. Omit it, or send it blank, for the unfiltered catalog.

limitintegerOptional1-1000Defaults to 50

Maximum number of results to return.

offsetintegerOptional>=0Defaults to 0

Number of results to skip for pagination.

Response headers

X-RateLimit-Limitinteger

How many requests this API key may make for this retailer in the current window. Sent only when the request was counted against that limit. A response served from cache was not counted and repeats the value it was cached with.

X-RateLimit-Remaininginteger

How many requests this API key has left for this retailer in the current window. Sent only when the request was counted against that limit. A response served from cache was not counted and repeats the value it was cached with.

Response

Paginated list of events.

datalist of objectsOptional

List of entities in the current page.

paginationobjectOptional

Pagination metadata.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

Authentication

Headers

Query parameters

Response headers

Response

Errors