API · Orders

Orders are completed ticket purchases. The API only returns orders that customers actually paid for — pending and abandoned orders are filtered out.

The status field reflects current state: paid, refund_pending, refunded, or partially_refunded.

GET /admin/orders

Returns paid orders in your account, with revenue stats for the period filter.

curl -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  https://app.usetix.io/admin/orders

Query parameters:

Parameter	Description
period	One of today, this_week, this_month, this_year, all_time. Defaults to this_month.
event_slug	Filter to orders for a specific event.
query	Free-text search across order public ID, customer email, and Stripe payment intent ID.

Response:

{
  "orders": [
    {
      "public_id": "abcd1234efgh5678",
      "status": "paid",
      "customer_name": "Jane Doe",
      "customer_email": "[email protected]",
      "total": { "amount": "42.00", "currency": "EUR" },
      "payment_provider": "stripe",
      "paid_at": "2026-04-22T12:34:50Z",
      "created_at": "2026-04-22T12:34:00Z",
      "item_count": 2
    }
  ],
  "stats": {
    "order_count": 1,
    "revenue": { "amount": "42.00", "currency": "EUR" }
  }
}

GET /admin/orders/:public_id

Returns a single order with its line items.

curl -H "Authorization: Bearer your-token-here" \
  -H "Accept: application/json" \
  https://app.usetix.io/admin/orders/abcd1234efgh5678

Response:

{
  "public_id": "abcd1234efgh5678",
  "status": "paid",
  "customer_name": "Jane Doe",
  "customer_email": "[email protected]",
  "total": { "amount": "42.00", "currency": "EUR" },
  "payment_provider": "stripe",
  "paid_at": "2026-04-22T12:34:50Z",
  "created_at": "2026-04-22T12:34:00Z",
  "item_count": 2,
  "items": [
    {
      "public_id": "ord_item_xyz789",
      "ticket_title": "General Admission",
      "event_id": 42,
      "event_slug": "spring-showcase",
      "redeemed": false,
      "redeemed_at": null
    }
  ]
}

Order fields

Field	Type	Notes
public_id	string	Public order ID. Stable; safe to store as your correlation key. URL-safe random token.
status	string	paid, refund_pending, refunded, or partially_refunded.
customer_name	string	Buyer’s name as entered at checkout.
customer_email	string	Buyer’s email.
total.amount	string	Order total as decimal string.
total.currency	string	ISO 4217 code.
payment_provider	string	stripe or paypal.
paid_at	string | null	ISO 8601 UTC. null if status is no longer paid.
created_at	string	ISO 8601 UTC. When the order was first opened.
item_count	integer	Number of tickets in the order.
items[].public_id	string	Public ID of the order item (one per ticket). Used in the customer’s QR code.
items[].ticket_title	string	Title of the ticket type at time of purchase.
items[].event_id	integer	Internal ID of the event this ticket belongs to.
items[].event_slug	string	Slug of the event. Useful for linking.
items[].redeemed	boolean	true once the QR code has been scanned at the door.
items[].redeemed_at	string | null	ISO 8601 UTC. null if not yet redeemed.