Get occurrence details | TTG Developer Portal

{
  "id": "67890",
  "starts_at": "2026-03-15T19:30:00-05:00",
  "venue": {
    "address": {
      "line1": "226 W 46th St",
      "line2": "Suite 200",
      "city": "New York",
      "state": "NY",
      "postal_code": "10036",
      "country": "US",
      "latitude": 40.759,
      "longitude": -73.9845
    },
    "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU",
    "name": "Richard Rodgers Theatre",
    "timezone": "America/New_York"
  },
  "ends_at": "2026-03-15T22:30:00-05:00",
  "from_price": {
    "amount": 18500,
    "currency": "USD"
  },
  "max_discount_amount": {
    "amount": 18500,
    "currency": "USD"
  },
  "max_discount_percentage": 25,
  "promotions": [
    {
      "id": "promo-opening-week",
      "name": "Opening Week Special"
    }
  ],
  "venue_map": {
    "id": "abc123-chart-key"
  }
}

Returns full details for a specific occurrence.

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

eventIdstringRequired>=1 character

occurrenceIdstringRequired>=1 character

Response

Occurrence details.

idstring

Unique identifier for the occurrence

starts_atstring

Start date and time of the occurrence in ISO 8601 with venue timezone offset

venueobject

Venue where the occurrence takes place

ends_atstring or null

End date and time of the occurrence in ISO 8601 with venue timezone offset. Null for events without a fixed end time.

from_priceobject

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

max_discount_amountobject

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

max_discount_percentageinteger or null

Maximum discount percentage available for this occurrence. Omitted when no discount is available.

promotionslist of objects

Active promotions for this occurrence. Omitted when no promotions apply.

venue_mapobject

Venue map/seating chart for inventory selection

$	curl https://stg.ttix.io/api/v3/events/123/occurrences/456 \
>	-H "X-TT-Retailer: X-TT-Retailer" \
>	-H "X-TT-Platform: android" \
>	-H "X-TT-API-Key: <apiKey>"

Authentication

Path parameters

Headers

Response