List occurrences for an event (browse with pricing)

Returns all occurrences for an event with pricing information for browse/selection UI.

Pricing fields (per occurrence):

fromPrice — Lowest available price (nullable when sold out or off-sale)
maxDiscountPercentage OR maxDiscountAmount — Max discount across all price points (optional, mutually exclusive)
promotions — Active promotions for this occurrence (optional array)

Key behaviors:

fromPrice: null means occurrence is unavailable (sold out or not yet on sale)
Discount fields are optional — omitted when no discount exists
Discount may be from a different price point than fromPrice (shows max savings)
Event-level config determines percentage vs amount discount display
promotions field is omitted when no active promotions exist

Returns all occurrences for an event with pricing information for browse/selection UI. **Pricing fields (per occurrence):** - `fromPrice` — Lowest available price (nullable when sold out or off-sale) - `maxDiscountPercentage` OR `maxDiscountAmount` — Max discount across all price points (optional, mutually exclusive) - `promotions` — Active promotions for this occurrence (optional array) **Key behaviors:** - `fromPrice: null` means occurrence is unavailable (sold out or not yet on sale) - Discount fields are optional — omitted when no discount exists - Discount may be from a different price point than `fromPrice` (shows max savings) - Event-level config determines percentage vs amount discount display - `promotions` field is omitted when no active promotions exist

Authentication

X-TT-API-Keystring

API key for authentication. Pass as X-TT-API-Key header.

Key prefixes:

Production: sk_live_*
Test: sk_test_*

Example: X-TT-API-Key: sk_live_abc123

API key for authentication. Pass as X-TT-API-Key header. Key prefixes: - Production: sk_live_* - Test: sk_test_* Example: X-TT-API-Key: sk_live_abc123

Path parameters

eventIdstringRequired

Unique identifier of the event.

Headers

Response

List of occurrences with pricing.

datalist of objects or null

Errors

Returns all occurrences for an event with pricing information for browse/selection UI.

Pricing fields (per occurrence):

fromPrice — Lowest available price (nullable when sold out or off-sale)
maxDiscountPercentage OR maxDiscountAmount — Max discount across all price points (optional, mutually exclusive)
promotions — Active promotions for this occurrence (optional array)

Key behaviors:

fromPrice: null means occurrence is unavailable (sold out or not yet on sale)
Discount fields are optional — omitted when no discount exists
Discount may be from a different price point than fromPrice (shows max savings)
Event-level config determines percentage vs amount discount display
promotions field is omitted when no active promotions exist

1	curl https://staging.todaytix.com/api/v3/events/123/occurrences \
2	-H "X-Client-Platform: ios" \
3	-H "X-Client-Version: 3.1.0" \
4	-H "Accept-Language: es-ES, es;q=0.9, en;q=0.8" \
5	-H "X-Request-ID: req_abc123xyz" \
6	-H "X-TT-API-Key: <apiKey>"

1	{
2	"data": [
3	{
4	"id": "123",
5	"startsAt": "2026-03-15T19:30:00-05:00",
6	"endsAt": "2026-03-15T22:30:00-05:00",
7	"fromPrice": {
8	"amount": 8500,
9	"currency": "USD"
10	},
11	"maxDiscountPercentage": 29,
12	"promotions": [
13	{
14	"id": "promo_789",
15	"name": "Theatre Sale"
16	}
17	]
18	},
19	{
20	"id": "124",
21	"startsAt": "2026-03-16T14:00:00-05:00",
22	"endsAt": "2026-03-16T16:30:00-05:00",
23	"fromPrice": {
24	"amount": 9500,
25	"currency": "USD"
26	},
27	"maxDiscountAmount": {
28	"amount": 5000,
29	"currency": "USD"
30	},
31	"promotions": [
32	{
33	"id": "promo_123",
34	"name": "Early Bird Special"
35	},
36	{
37	"id": "promo_456",
38	"name": "Student Rush"
39	}
40	]
41	},
42	{
43	"id": "125",
44	"startsAt": "2026-03-16T19:30:00-05:00"
45	}
46	]
47	}