List occurrences for an event (browse with pricing)
List occurrences for an event (browse with pricing)
Returns a paginated list of occurrences for an event with pricing information for browse/selection UI.
**Pricing fields (per occurrence):**
- `fromPrice` — Lowest available price (null when sold out or off-sale)
- `maxDiscountAmount` — Max discount amount (always present when a discount exists)
- `maxDiscountPercentage` — Max discount percentage (present only when event allows percentage display)
**Key behaviors:**
- `fromPrice` is null when occurrence is unavailable (sold out or not yet on sale)
- `maxDiscountAmount` is always included when a discount exists
- `maxDiscountPercentage` is included only when the event is configured for percentage display
- Discount may be from a different price point than `fromPrice` (represents max savings)
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`.
Authentication
X-TT-API-Keystring
API Key authentication via header
Path parameters
eventId
Headers
X-TT-Retailer
Retailer public ID
X-TT-Currency
ISO 4217 currency to price in. Omit for base currency; an unsupported or invalid currency returns 400.
X-TT-Platform
Identifies the platform the request comes from.
Allowed values:
Query parameters
quantity
Minimum ticket quantity
startDate
Date range start (inclusive, ISO 8601 date)
endDate
Date range end (inclusive, ISO 8601 date)
limit
Maximum number of results to return.
offset
Number of results to skip for pagination.
Response
Paginated list of occurrences with pricing.