List occurrences for an event (browse with pricing)

curl -G https://stg.ttix.io/api/v3/events/123/occurrences \
     -H "X-TT-Retailer: X-TT-Retailer" \
     -H "X-TT-Platform: android" \
     -H "X-TT-API-Key: <apiKey>" \
     -d quantity=2 \
     -d startDate=2026-03-15 \
     -d endDate=2026-03-31 \
     -d limit=50 \
     -d offset=0

{
  "data": [
    {
      "id": "123",
      "startsAt": "2026-03-15T19:30:00-05:00",
      "endsAt": "2026-03-15T22:30:00-05:00",
      "availabilityLevel": null,
      "fromPrice": {
        "amount": 8500,
        "currency": "USD"
      },
      "maxDiscountPercentage": 25,
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU=",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "city": "New York",
          "state": "NY",
          "postalCode": "10036",
          "country": "US"
        },
        "timezone": "America/New_York"
      },
      "venueMap": {
        "id": "abc123-chart-key"
      }
    },
    {
      "id": "124",
      "startsAt": "2026-03-16T14:00:00-05:00",
      "endsAt": "2026-03-16T16:30:00-05:00",
      "availabilityLevel": "LOW",
      "fromPrice": {
        "amount": 9500,
        "currency": "USD"
      },
      "maxDiscountAmount": {
        "amount": 5000,
        "currency": "USD"
      },
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU=",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "city": "New York",
          "state": "NY",
          "postalCode": "10036",
          "country": "US"
        },
        "timezone": "America/New_York"
      }
    },
    {
      "id": "125",
      "startsAt": "2026-03-16T19:30:00-05:00",
      "availabilityLevel": "SOLD_OUT",
      "fromPrice": null,
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU=",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "city": "New York",
          "state": "NY",
          "postalCode": "10036",
          "country": "US"
        },
        "timezone": "America/New_York"
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 3
  }
}

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:

Sold-out occurrences are included, with availabilityLevel: "SOLD_OUT" and fromPrice: null
availabilityLevel signals remaining availability: LOW, SOLD_OUT, or null when there is no signal
When quantity is set, availability and pricing reflect only inventory that can seat that many tickets together
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; one it is sold in but that cannot be priced right now returns 503.

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:** - Sold-out occurrences are included, with `availabilityLevel: "SOLD_OUT"` and `fromPrice: null` - `availabilityLevel` signals remaining availability: `LOW`, `SOLD_OUT`, or null when there is no signal - When `quantity` is set, availability and pricing reflect only inventory that can seat that many tickets together - `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`; 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

Query parameters

quantitystringOptional

Minimum ticket quantity. Pricing and availabilityLevel then reflect only inventory that can seat this many tickets together — an occurrence without enough seats reads as SOLD_OUT.

startDatestringOptional

Date range start (inclusive, ISO 8601 date)

endDatestringOptional

Date range end (inclusive, ISO 8601 date)

limitstringRequired

Maximum number of results to return.

offsetstringRequired

Number of results to skip for pagination.

Response

Paginated list of occurrences with pricing.