Get order by ID | TTG Developer Portal

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

{
  "id": "12345",
  "confirmationNumber": "T123456789012",
  "contact": {
    "name": "John Smith",
    "email": "john.smith@example.com",
    "phone": "+12125550123"
  },
  "items": [
    {
      "id": "12345",
      "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,
      "tickets": [
        {
          "id": "tkt-001",
          "status": "CONFIRMED",
          "barcode": {
            "value": "TKT-2026-031519-A101",
            "format": "QR",
            "imageUrl": "https://cdn.ttix.io/barcodes/tkt-001.png"
          }
        }
      ]
    }
  ],
  "receiptLines": [
    {
      "label": "Subtotal",
      "sign": "positive",
      "_type": "SubtotalLine"
    }
  ],
  "status": "COMPLETED",
  "createdAt": "2026-03-10T14:32:00Z",
  "protection": {
    "id": "prot_001",
    "status": "ELIGIBLE"
  }
}

Retrieve a completed order by its unique identifier. When cartId is provided as a query parameter, the server validates it against the hold transaction and grants access without requiring customer authentication.

Authentication

X-TT-API-Keystring

API Key authentication via header

Path parameters

orderIdlongRequired

Query parameters

cartIdstringOptional

Cart ID for authorization. Grants access without customer authentication.

Response

Order found successfully.

idstring

Unique identifier for the order

confirmationNumberstring

Human-readable confirmation number for customer support and emails

contactobject

Contact information for order fulfillment

itemslist of objects

Purchased order items in this order

receiptLineslist of objects

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

totalany

statusenum

Current status of the order

Allowed values:

createdAtstring

When the order was created (UTC)

protectionobject

Protection covering all items. Null if not added.

totalTaxesany