List available inventory items | TTG Developer Portal

curl -G https://stg.ttix.io/api/v3/events/123/occurrences/456/inventory-items \
     -H "X-TT-Platform: android" \
     -H "X-TT-API-Key: <apiKey>" \
     -d providerCode=campaign-may \
     -d limit=50 \
     -d offset=0

{
  "data": [
    {
      "id": "v1_AQAAAAPoAAAABk9yY2hlc3RyYS1BLTEwMQ",
      "inventoryVariant": {
        "_type": "AssignedSeat",
        "id": "Orchestra-A-101",
        "name": "Orchestra A 101",
        "section": "Orchestra",
        "row": "A",
        "seat": "101",
        "attributes": []
      },
      "quantityAvailable": 1,
      "priceOptions": [
        {
          "id": "SeeTickets:FULL",
          "category": {
            "name": "Adult"
          },
          "listPrice": {
            "amount": 15000,
            "currency": "USD"
          },
          "sellPrice": {
            "amount": 17000,
            "currency": "USD"
          }
        }
      ]
    },
    {
      "id": "v1_AQAAAAPoAAAABkZsb29yIEdB",
      "inventoryVariant": {
        "_type": "GeneralAdmission",
        "id": "General-Admission",
        "name": "General Admission",
        "attributes": []
      },
      "quantityAvailable": 50,
      "priceOptions": [
        {
          "id": "42",
          "category": {
            "name": "Adult"
          },
          "sellPrice": {
            "amount": 9500,
            "currency": "USD"
          }
        },
        {
          "id": "43",
          "category": {
            "name": "Child"
          },
          "sellPrice": {
            "amount": 6500,
            "currency": "USD"
          }
        }
      ]
    },
    {
      "id": "invitem-extra-wine",
      "inventoryVariant": {
        "_type": "Extra",
        "id": "var-extra-white-wine",
        "name": "White Wine",
        "attributes": []
      },
      "quantityAvailable": 100,
      "priceOptions": [
        {
          "id": "po-standard",
          "category": {
            "name": "Standard"
          },
          "listPrice": {
            "amount": 15000,
            "currency": "USD"
          },
          "sellPrice": {
            "amount": 1320,
            "currency": "USD"
          }
        }
      ]
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 3
  }
}

Returns a paginated list of purchasable inventory for an occurrence. Use the inventoryVariant._type field to differentiate between item types:

AssignedSeat — specific physical seat (section, row, seat number)
GeneralAdmission — GA area with available quantity
Extra — Extra (drinks, merchandise, parking)

InventoryVariant.id is stable across all occurrences, enabling seating chart integration.

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. If prices cannot be converted to a supported currency, they come back in the event base currency.

Returns a paginated list of purchasable inventory for an occurrence. Use the `inventoryVariant._type` field to differentiate between item types: - `AssignedSeat` — specific physical seat (section, row, seat number) - `GeneralAdmission` — GA area with available quantity - `Extra` — Extra (drinks, merchandise, parking) `InventoryVariant.id` is stable across all occurrences, enabling seating chart integration. 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`. If prices cannot be converted to a supported currency, they come back in the event base currency.

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

eventIdstringRequiredformat: "^[1-9]\d*$">=1 character

occurrenceIdstringRequiredformat: "^[1-9]\d*$">=1 character

Query parameters

providerCodestringOptionalformat: ".*\S.*"0-255 characters

Optional provider code identifying which configured pricing tier should price this request. Retailers running concurrent pricing tiers on a single credential use this to select among them. Omitting the code prices at the default tier; a code not configured for this event and retailer is rejected with a 404 naming the code.

limitstringRequired

Maximum number of results to return.

offsetstringRequired

Number of results to skip for pagination.

Response

Paginated list of available inventory items.

Authentication

Path parameters

Headers

Query parameters

Response