Get order by ID | TTG Developer Portal

curl https://staging.todaytix.com/api/v3/orders/101 \
     -H "X-Client-Platform: ios" \
     -H "X-Client-Version: 3.1.0" \
     -H "Accept-Language: es-ES, es;q=0.9, en;q=0.8" \
     -H "X-Request-ID: req_abc123xyz" \
     -H "X-TT-API-Key: <apiKey>"

{
  "id": "123",
  "confirmationNumber": "T123456789012",
  "contact": {
    "name": "John Smith",
    "email": "john.smith@example.com",
    "phone": "+12125550123"
  },
  "items": [
    {
      "id": "orderitem-001",
      "event": {
        "id": "123",
        "name": "Hamilton",
        "category": "Musical"
      },
      "occurrence": {
        "id": "123",
        "startsAt": "2026-03-15T19:30:00-05:00"
      },
      "venue": {
        "id": "ven_richard_rodgers",
        "name": "Richard Rodgers Theatre",
        "address": {
          "line1": "226 W 46th St",
          "city": "New York",
          "country": "US",
          "line2": "Suite 200",
          "state": "NY",
          "postalCode": "10036",
          "latitude": 40.7589,
          "longitude": -73.9851
        },
        "timezone": "America/New_York"
      },
      "inventoryVariant": {
        "id": "var-seat-orch-a-101",
        "_type": "AssignedSeat",
        "attributes": [
          {
            "category": "NEGATIVE",
            "description": "Seats in this row have reduced legroom due to a safety barrier.",
            "name": "Limited Legroom"
          }
        ],
        "name": "Orchestra A 101",
        "section": "Orchestra",
        "row": "A",
        "seat": "101"
      },
      "priceOption": {
        "id": "po-adult",
        "category": {
          "name": "Adult"
        },
        "sellPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "listPrice": {
          "amount": 18500,
          "currency": "USD"
        },
        "totalFees": {
          "amount": 18500,
          "currency": "USD"
        }
      },
      "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": [
    {
      "_type": "SubtotalLine",
      "label": "string",
      "total": {
        "amount": 18500,
        "currency": "USD"
      },
      "sign": "positive"
    }
  ],
  "total": {
    "amount": 18500,
    "currency": "USD"
  },
  "status": "COMPLETED",
  "createdAt": "2026-03-10T14:32:00Z",
  "protection": {
    "id": "prot_001",
    "perTicketAmount": {
      "amount": 18500,
      "currency": "USD"
    },
    "total": {
      "amount": 18500,
      "currency": "USD"
    },
    "status": "ELIGIBLE"
  },
  "totalTaxes": {
    "amount": 18500,
    "currency": "USD"
  }
}

Retrieve a completed order by its unique identifier.

Authentication

X-TT-API-Keystring

API key for authentication. Pass as X-TT-API-Key header.

Key prefixes:

Production: sk_live_*
Test: sk_test_*

Example: X-TT-API-Key: sk_live_abc123

API key for authentication. Pass as X-TT-API-Key header. Key prefixes: - Production: sk_live_* - Test: sk_test_* Example: X-TT-API-Key: sk_live_abc123

Path parameters

orderIdstringRequired

Unique identifier of the order.

Headers

Response

Order found successfully.

idstring

Order ID (machine-readable)

confirmationNumberstring

Human-readable confirmation number for customer support and emails.

contactobject

Contact information for this order (pickup, delivery, confirmation). Single source of truth for order contact details.

itemslist of objects

Items representing what was purchased (OrderItems with embedded tickets).

Structure: Each OrderItem contains a nested tickets[] array with fulfillment tickets. Does NOT include: Fees, protection, or credits — see receiptLines for those.

receiptLineslist of objects

Server-ordered display lines for receipt rendering. Iterate in sequence. Always includes SubtotalLine. Conditionally: FeeLine, VoucherLine, ProtectionLine.

totalobject

Total amount charged. Server-computed. Never derive from parts.

statusenum

Current status of the order.

Allowed values:

createdAtdatetime

When the order was created (UTC).

protectionobject or null

Protection applied to this order. Null if not purchased.

totalTaxesobject or null

DISCLOSURE ONLY - taxes already included in total. Omitted when not disclosed (e.g., UK market).

Authentication

Path parameters

Headers

Response

Errors