orders

get customer

The person, their orders in the same row shape the Orders list serves, their returns, and what has been refunded to them across every channel they bought on. Call it to answer a question about a buyer; do not call it in a loop over a list, which is what the list itself is for. There is no write: a customer is created by the order writers and by the sync, never by this API.

refund_status.refunded is a money leg summed off the orders' own refunded amounts, which are the channel's figures and are never recomputed from lines. cents null with a reason beside it means no order of theirs has been refunded, which is absence and not a refund of nothing. redacted_at set means the identity was cleared on a channel's erasure event: the name, the email pseudonym and the domain are gone, and the orders, their lines and their figures were all kept.

Scope: orders:read.

get/api/v1/sales/customers/{customer_id}

Request

  • Base URL: https://api.app.tightly.io
  • URL: https://api.app.tightly.io/api/v1/sales/customers/{customer_id}
  • Auth: HTTP bearer

Path parameters

customer_idstring required

The customer's id, as List customers and an order's customer block serve it.

Headers

Tightly-Versionstring
Example:2026-11

The date train to answer on. One train exists today, 2026-11, the one this reference describes and the one every key is minted on, so the call answers on it with or without this header. Send it anyway, so a client built now names its train from the start.

Response

The customer, their orders, their returns and what has been refunded.

dataobject

the customer, orders, returns and refund_status.

messageobject

severity, service and desc.

Changes

No recorded changes to this operation across all 1 revision of this API.