API ReferenceBrowseOccurrences

Get occurrence details

Returns full details for a specific occurrence. A sold-out occurrence is returned with `availabilityLevel: "SOLD_OUT"` and `fromPrice: null`. Send the `X-TT-Currency` header to receive prices in that currency. Omit it to get base-currency prices. A currency this event is not sold in returns `400`; one it is sold in but that cannot be priced right now returns `503`.

Authentication

X-TT-API-Keystring
API Key authentication via header

Path parameters

eventIdstringRequired>=1 character
occurrenceIdstringRequired>=1 character

Headers

X-TT-RetailerstringRequired
Retailer public ID
X-TT-CurrencystringOptional

ISO 4217 currency to price in. Omit for base currency; an unsupported or invalid currency returns 400, and a currency that cannot be priced right now returns 503.

X-TT-PlatformenumRequired
Identifies the platform the request comes from.
Allowed values:

Response

Occurrence details.
admissionTypeenum
How admission works for this occurrence. TIMED means entry on a specific day at a specific time. DATED means entry on a specific day, any time between open and close. OPEN means entry on any day at any time. SLOT means entry at any time between the start and end times.
idstring
Unique identifier for the occurrence
startsAtstring
Start date and time of the occurrence in ISO 8601 with venue timezone offset
venueobject
Venue where the occurrence takes place
availabilityLevelenum or nullOptional

How much availability remains for this occurrence. SOLD_OUT means no tickets are currently available for purchase (relative to the requested quantity when provided). LOW means tickets are running out. Null means no availability signal — display the occurrence normally. New values may be added over time; treat any unrecognized value as no signal.

doorsOpenobjectOptional
When doors open at the venue for this occurrence.
endsAtstring or nullOptional
End date and time of the occurrence in ISO 8601 with venue timezone offset. Null for events without a fixed end time.
fromPriceobjectOptional

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

maxDiscountAmountobjectOptional

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

maxDiscountPercentageinteger or nullOptional
Maximum discount percentage available for this occurrence. Omitted when no discount is available.
noticeslist of objectsOptional
Notices about this occurrence, such as cast changes or accessibility services. Omitted when there are none.
partTwoStartsAtstring or nullOptional
Start date and time of the second part of the occurrence in ISO 8601 with venue timezone offset. Only present for events performed in two parts.
promotionslist of objectsOptional
Active promotions for this occurrence. Omitted when no promotions apply.
venueMapobjectOptional

Venue map/seating chart for inventory selection