Get order by ID | TTG Developer Portal

{
  "id": "12345",
  "confirmation_number": "T123456789012",
  "contact": {
    "name": "John Smith",
    "email": "john.smith@example.com",
    "phone": "+12125550123"
  },
  "items": [
    {
      "id": "12345",
      "event": {
        "id": "123",
        "name": "Hamilton"
      },
      "occurrence": {
        "id": "456",
        "starts_at": "2026-03-15T19:30:00-05:00"
      },
      "venue": {
        "id": "UmljaGFyZCBSb2RnZXJzIFRoZWF0cmU",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "line2": "Suite 200",
          "city": "New York",
          "state": "NY",
          "postal_code": "10036",
          "country": "US",
          "latitude": 40.759,
          "longitude": -73.9845
        },
        "timezone": "America/New_York"
      },
      "inventory_variant": {
        "_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"
      },
      "price_option": {
        "category": {
          "name": "Adult"
        },
        "sell_price": {
          "amount": 18500,
          "currency": "USD"
        },
        "id": "eyJjIjoiRlVMTCJ9",
        "list_price": {
          "amount": 18500,
          "currency": "USD"
        },
        "max_quantity_per_order": 4,
        "promotion": {
          "id": "promo-opening-week",
          "name": "Opening Week Special",
          "description": "40% off Orchestra seats for opening week performances."
        }
      },
      "quantity": 1,
      "tickets": [
        {
          "id": "tkt-001",
          "status": "CONFIRMED",
          "barcode": {
            "value": "TKT-2026-031519-A101",
            "format": "QR",
            "image_url": "https://cdn.ttix.io/barcodes/tkt-001.png"
          }
        }
      ],
      "delivery": {
        "method": {
          "name": "E-ticket"
        },
        "instructions": "Your e-tickets will be emailed to you before the performance."
      }
    }
  ],
  "receipt_lines": [
    {
      "label": "Subtotal",
      "total": {
        "amount": 18500,
        "currency": "USD"
      },
      "sign": "positive",
      "_type": "SubtotalLine"
    }
  ],
  "total": {
    "amount": 18500,
    "currency": "USD"
  },
  "status": "COMPLETED",
  "created_at": "2026-03-10T14:32:00Z",
  "protection": {
    "id": "prot_001",
    "price_per_item": {
      "amount": 18500,
      "currency": "USD"
    },
    "total": {
      "amount": 18500,
      "currency": "USD"
    },
    "status": "ELIGIBLE"
  },
  "total_taxes": {
    "amount": 18500,
    "currency": "USD"
  }
}

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

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

Query parameters

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

Cart ID for authorization. Grants access without customer authentication.

Response

Order found successfully.

idstring

Unique identifier for the order

confirmation_numberstring

Human-readable confirmation number for customer support and emails

contactobject

Contact information for order fulfillment

itemslist of objects

Purchased order items in this order

receipt_lineslist of objects

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

totalobject

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

statusenum

Current status of the order

created_atstring

When the order was created (UTC)

protectionobject

Protection covering all items. Null if not added.

total_taxesobject

Monetary amount in minor units (cents for USD). Never uses floating point to avoid precision errors.

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

Authentication

Path parameters

Headers

Query parameters

Response