Get cart | TTG Developer Portal

curl https://stg.ttix.io/api/v3/carts/6aac14d3-5826-4da8-98b6-9e68c28629d6 \
     -H "X-TT-API-Key: <apiKey>"

{
  "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"
  }
}

Returns the current state of a cart, including all line items and hold expiration times.

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

cartIdstringRequiredformat: "(?i)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"

Response

Cart details.

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