Place an order | TTG Developer Portal

curl -X POST https://stg.ttix.io/api/v3/orders \
     -H "X-TT-Device-Data: X-TT-Device-Data" \
     -H "X-TT-Platform: android" \
     -H "X-TT-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "cartId": "string",
  "expectedTotal": {
    "amount": 18500,
    "currency": "USD"
  },
  "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"
      },
      "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"
      },
      "priceOption": {
        "category": {
          "name": "Adult"
        },
        "sellPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "id": "eyJjIjoiRlVMTCJ9",
        "listPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "maxQuantityPerOrder": 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",
            "imageUrl": "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."
      }
    }
  ],
  "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"
  }
}

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}$">=1 character

expectedTotalobjectRequired

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

contactobjectRequired

paymentobjectRequired

marketingConsentobjectOptional

Response

The Idempotency-Key already completed an order for this cart. The existing order is returned and nothing is charged or issued again.

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.

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.

Authentication

Headers

Request

Response