List events | TTG Developer Portal

curl -G https://stg.ttix.io/api/v3/events \
     -H "X-TT-Retailer: X-TT-Retailer" \
     -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",
      "displayName": "Hamilton",
      "endDate": "2026-12-31",
      "fromPrice": {
        "amount": 8900,
        "currency": "USD"
      },
      "location": {
        "id": "1",
        "name": "New York",
        "country": "US",
        "slug": "nyc"
      },
      "maxDiscountPercentage": 25,
      "name": "Hamilton",
      "orderLimit": {
        "min": 1,
        "max": 8
      },
      "productType": "SHOW",
      "slug": "hamilton-broadway",
      "startDate": "2026-03-01"
    },
    {
      "id": "457",
      "displayName": "Phantom",
      "endDate": null,
      "fromPrice": {
        "amount": 3500,
        "currency": "GBP"
      },
      "location": {
        "id": "2",
        "name": "London",
        "country": "GB",
        "slug": "london"
      },
      "name": "The Phantom of the Opera",
      "orderLimit": {
        "min": 1,
        "max": 6
      },
      "productType": "SHOW",
      "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*$"

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.

limitstringRequired

Maximum number of results to return.

offsetstringRequired

Number of results to skip for pagination.

Response

Paginated list of events.

Authentication

Headers

Query parameters

Response