List available inventory items | TTG Developer Portal

curl -G https://stg.ttix.io/api/v3/events/123/occurrences/456/inventory-items \
     -H "X-TT-API-Key: <apiKey>" \
     -d useProviderInventoryItems=false \
     -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.

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.

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

useProviderInventoryItemsstringOptionalDefaults to false

When true, returns inventory via the new flat inventory representation instead of the legacy sections-based inventory. Migration toggle; defaults to false.

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; omitted or unrecognised codes fall back to the default tier.

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