Create a cart | TTG Developer Portal

curl -X POST https://stg.ttix.io/api/v3/carts \
     -H "X-TT-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    {
      "occurrenceId": "123",
      "inventoryItemId": "eyJwcm92aWRlcklkIjo0NTYsInNlYXRJZCI6IlNUQUxMUy1BLTEifQ",
      "priceOptionId": "eyJwcm92aWRlckNvZGUiOiJGVUxMUFJJQ0UiLCJob2xkQ29kZSI6IjE1NzM5In0",
      "quantity": 1
    }
  ]
}'

{
  "id": "6aac14d3-5826-4da8-98b6-9e68c28629d6",
  "expiresAt": "2026-03-15T19:40:00Z",
  "items": [
    {
      "id": "001",
      "event": {
        "id": "123",
        "name": "Hamilton"
      },
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU",
        "name": "Richard Rodgers Theatre",
        "timezone": "America/New_York"
      },
      "inventoryVariant": {
        "_type": "AssignedSeat",
        "attributes": [
          {
            "name": "Limited Legroom",
            "category": "NEGATIVE",
            "description": "Seats in this row have reduced legroom due to a safety barrier."
          }
        ],
        "id": "Orchestra-A-101",
        "name": "Orchestra A 101",
        "row": "A",
        "seat": "101",
        "section": "Orchestra"
      },
      "quantity": 1
    }
  ],
  "receiptLines": [
    {
      "label": "Subtotal",
      "sign": "positive",
      "_type": "SubtotalLine"
    }
  ],
  "protection": {
    "id": "prot_001",
    "status": "ELIGIBLE"
  }
}

Creates a new cart and adds inventory items to it in a single request. Holds the inventory for the customer.

AssignedSeat variants always require quantity: 1 (each seat is unique)
GeneralAdmission and Extra variants support quantity > 1
All items must be from the same event + occurrence.

Creates a new cart and adds inventory items to it in a single request. Holds the inventory for the customer. - `AssignedSeat` variants always require `quantity: 1` (each seat is unique) - `GeneralAdmission` and `Extra` variants support `quantity > 1` - All items must be from the same event + occurrence.

Authentication

X-TT-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

itemslist of objectsRequired

Response

Cart created successfully.

idstring

Cart ID

expiresAtstring

UTC timestamp when the cart hold expires and inventory is released. Clients should display a countdown timer and warn users before expiration.

itemslist of objects

Items currently in the cart (held inventory). Does NOT include fees, protection, or credits — see receiptLines for those.

receiptLineslist of objects

Server-ordered display lines for receipt rendering. Iterate in sequence. Always includes SubtotalLine. Conditionally: VoucherLine, ProtectionLine.

totalany

protectionobject

Protection covering all items. Null if not added.

totalTaxesany