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

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 (subtotal, vouchers, protection; fees are disclosed per item on priceOption.fees)

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 (subtotal, vouchers, protection; fees are disclosed per item on `priceOption.fees`) 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

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

Headers

Request

Response