Place an order | TTG Developer Portal

curl -X POST https://stg.ttix.io/api/v3/orders \
     -H "X-TT-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "cartId": "string",
  "contact": {
    "name": "string",
    "email": "string"
  },
  "payment": {
    "method": "CARD"
  }
}'

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

Check out a held cart. On success, tickets are issued and the cart is cleared.

Order response structure (three-level nesting):

items[] — Array of OrderItems (what you purchased with pricing details)
- items[].tickets[] — Tickets nested within each OrderItem (admission fulfillment)
receiptLines[] — Array of display rows for receipt rendering (fees, vouchers, subtotal)

Tickets are embedded within OrderItems, not at the top level of the Order.

Check out a held cart. On success, tickets are issued and the cart is cleared. **Order response structure** (three-level nesting): - **`items[]`** — Array of OrderItems (what you purchased with pricing details) - **`items[].tickets[]`** — Tickets nested within each OrderItem (admission fulfillment) - **`receiptLines[]`** — Array of display rows for receipt rendering (fees, vouchers, subtotal) Tickets are embedded within OrderItems, not at the top level of the Order.

Authentication

X-TT-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

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

expectedTotalanyRequired

contactobjectRequired

paymentobjectRequired

Response

Order created and tickets issued.

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