API · Customers

Customers are the people who’ve purchased tickets in your account. A customer record is created on the first paid order; subsequent orders attach to the same record (matched by email).

Use this endpoint to sync your buyer list to a CRM, mailing list, or analytics tool.

GET /admin/customers

Returns customers for your account, with aggregate stats.

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

Query parameters:

Parameter	Description
period	One of today, this_week, this_month, this_year, all_time. Filters customers by their first-order date. Defaults to this_month.
event_slug	Only customers who bought at least one ticket to this event.
query	Free-text search across email, name, and company.
marketing_only	1 to return only customers who opted into marketing.

Response:

{
  "customers": [
    {
      "id": 17,
      "email": "[email protected]",
      "name": "Jane Doe",
      "company": null,
      "total_spent": { "amount": "126.00", "currency": "EUR" },
      "marketing_consent": true,
      "marketing_consent_at": "2026-04-22T12:34:50Z",
      "created_at": "2026-04-22T12:34:50Z"
    }
  ],
  "stats": {
    "customer_count": 1,
    "total_spent": { "amount": "126.00", "currency": "EUR" }
  }
}

GET /admin/customers/:id

Returns a single customer along with all their paid orders.

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

Response:

{
  "id": 17,
  "email": "[email protected]",
  "name": "Jane Doe",
  "company": null,
  "total_spent": { "amount": "126.00", "currency": "EUR" },
  "marketing_consent": true,
  "marketing_consent_at": "2026-04-22T12:34:50Z",
  "created_at": "2026-04-22T12:34:50Z",
  "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
    }
  ]
}

The orders array uses the same shape as the orders endpoint.

Customer fields

Field	Type	Notes
id	integer	Internal numeric ID. Path parameter.
email	string	Lowercased, normalized email. Uniquely identifies a customer within an account.
name	string | null	Buyer’s name as entered at checkout.
company	string | null	Optional company / organization.
total_spent.amount	string	Lifetime spend across paid orders, as a decimal string. Refunded amounts subtract.
total_spent.currency	string	ISO 4217 code (your account currency).
marketing_consent	boolean	true if the customer opted into marketing emails at any checkout.
marketing_consent_at	string | null	ISO 8601 UTC of when consent was given. null if never given.
created_at	string	ISO 8601 UTC of when this customer record was created (first paid order).