Place an order | TTG Developer Portal

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

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

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.

cart_idstringRequiredformat: "(?i)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$">=1 character

expected_totalobjectRequired

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

contactobjectRequired

paymentobjectRequired

marketing_consentobjectOptional

Response

Order created and tickets issued.

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.

Authentication

Headers

Request

Response