Get order by ID | TTG Developer Portal

{
  "id": "12345",
  "confirmationNumber": "T123456789012",
  "customerId": "c.pm2fiairy2y6a6rpbf5",
  "contact": {
    "name": "John Smith",
    "email": "john.smith@example.com",
    "phone": "+12125550123"
  },
  "items": [
    {
      "id": "12345",
      "event": {
        "id": "123",
        "name": "Hamilton"
      },
      "occurrence": {
        "id": "456",
        "startsAt": "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",
          "postalCode": "10036",
          "country": "US",
          "latitude": 40.759,
          "longitude": -73.9845
        },
        "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",
        "description": "Closest to the stage",
        "extendedDescription": "Includes a complimentary drink. **Over 18s only.**"
      },
      "priceOption": {
        "category": {
          "name": "Adult",
          "id": "4471",
          "description": "Ages 3-12"
        },
        "sellPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "id": "eyJjIjoiRlVMTCJ9",
        "constraints": {
          "requiresCategory": [
            "string"
          ]
        },
        "listPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "discountPercentage": 30,
        "discountAmount": {
          "amount": 18500,
          "currency": "USD"
        },
        "fees": [
          {
            "type": "SERVICE_FEE",
            "value": {
              "amount": 18500,
              "currency": "USD"
            }
          }
        ],
        "maxQuantityPerOrder": 4,
        "promotion": {
          "id": "promo-opening-week",
          "name": "Opening Week Special",
          "description": "40% off Orchestra seats for opening week performances."
        },
        "isDefault": true
      },
      "quantity": 1,
      "delivery": {
        "method": {
          "name": "E-ticket"
        },
        "instructions": "Your e-tickets will be emailed to you before the performance."
      },
      "tickets": [
        {
          "id": "tkt-001",
          "status": "CONFIRMED",
          "assignedCustomer": {
            "firstName": "Jordan",
            "lastName": "Lee"
          },
          "barcode": {
            "value": "TKT-2026-031519-A101",
            "format": "QR",
            "imageUrl": "https://cdn.ttix.io/barcodes/tkt-001.png"
          }
        }
      ]
    }
  ],
  "receiptLines": [
    {
      "label": "Subtotal",
      "total": {
        "amount": 18500,
        "currency": "USD"
      },
      "sign": "positive",
      "_type": "SubtotalLine"
    }
  ],
  "total": {
    "amount": 18500,
    "currency": "USD"
  },
  "status": "COMPLETED",
  "createdAt": "2026-03-10T14:32:00Z",
  "protection": {
    "id": "prot_001",
    "pricePerItem": {
      "amount": 18500,
      "currency": "USD"
    },
    "total": {
      "amount": 18500,
      "currency": "USD"
    },
    "status": "ELIGIBLE"
  },
  "totalTaxes": {
    "amount": 18500,
    "currency": "USD"
  },
  "cancellationVoucher": {
    "code": "PWYHYCRSGZAXKPE",
    "value": {
      "amount": 18500,
      "currency": "USD"
    },
    "type": "CANCELLATION",
    "isExpired": false,
    "balance": {
      "amount": 18500,
      "currency": "USD"
    },
    "expiresAt": "2027-04-20"
  }
}

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.

By default, the purchaser sees all items in the order. An invited guest can access only the items to which they were invited.

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

confirmationNumberstring

Human-readable confirmation number for customer support and emails

customerIdstring

Identifier for the customer who placed this order

contactobject

Contact information for order fulfillment

itemslist of objects

Items purchased in this order. By default, the purchaser sees all items in the order. An invited guest can access only the items to which they were invited.

receiptLineslist 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

createdAtstring

When the order was created (UTC)

protectionobjectOptional

Protection covering all items. Null if not added.

totalTaxesobjectOptional

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

cancellationVoucherobjectOptional

Credit voucher issued when the order was cancelled or exchanged

Authentication

Path parameters

Headers

Query parameters

Response