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-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",
      "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",
      "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",
      "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:

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)

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)

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

eventIdstringRequired

Query parameters

quantitystringOptional

Minimum ticket quantity

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.

Authentication

Path parameters

Headers

Query parameters

Response