Get occurrence details | TTG Developer Portal

{
  "data": {
    "admissionType": "TIMED",
    "id": "123",
    "orderLimit": {
      "max": 8,
      "min": 1
    },
    "startsAt": "2026-03-15T19:30:00-04:00",
    "venue": {
      "address": {
        "line1": "226 W 46th St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10036",
        "country": "US"
      },
      "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU=",
      "name": "Richard Rodgers Theatre",
      "timezone": "America/New_York"
    },
    "availabilityLevel": null,
    "endsAt": "2026-03-15T22:30:00-04:00",
    "fromPrice": {
      "amount": 8500,
      "currency": "USD"
    },
    "maxDiscountAmount": {
      "amount": 3000,
      "currency": "USD"
    },
    "maxDiscountPercentage": 25,
    "venueMap": {
      "id": "abc123-chart-key"
    }
  }
}

Returns full details for a specific occurrence.

A sold-out occurrence is returned with availabilityLevel: "SOLD_OUT" and fromPrice: null.

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

eventIdstringRequired>=1 character

Event ID

occurrenceIdstringRequired>=1 character

Occurrence ID

Query parameters

currencystringOptionalformat: "^[A-Z]{3}$"

ISO 4217 currency to price in. Omit for the event base currency. A currency this event is not sold in returns 400; one it is sold in but that cannot be priced right now returns 503.

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

Occurrence details.

dataobject

A dated occurrence of an event, with its venue, availability and price summary.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error