`GET /customers/{id}`

Retrieve a single customer by id.

curl "$BASE_URL/customers/cust_01HZ…" \
  -H "Api-Key: $SEISMIC_ORCHESTRATION_API_KEY"

The Customer object

Same shape returned by POST /customers, GET /customers, and PUT /customers/{id}.

{
  "id": "cust_01HZ…",
  "type": "individual",
  "email": "alice@example.com",
  "status": "awaiting_questionnaire",
  "first_name": "Alice",
  "last_name": "Zhang",
  "has_accepted_terms_of_service": false,
  "capabilities": {
    "payin_crypto": "pending",
    "payout_crypto": "pending",
    "payin_fiat": "pending",
    "payout_fiat": "pending"
  },
  "endorsements": [
    {
      "name": "base",
      "status": "incomplete",
      "requirements": {
        "complete": [],
        "pending": ["tos_acceptance"],
        "missing": {},
        "issues": []
      }
    }
  ],
  "requirements_due": ["tos_acceptance"],
  "future_requirements_due": [],
  "rejection_reasons": [],
  "created_at": "2026-04-24T12:00:00Z",
  "updated_at": "2026-04-24T12:00:00Z"
}

Response fields

Field	Type	Notes
`id`	string (UUID)	Compat id.
`type`	`individual` \| `business`
`email`	string
`status`	`CustomerStatus`
`first_name`, `last_name`	string	Individual only. Absent for business.
`business_legal_name`	string	Business only.
`persona_inquiry_type`	string	Bridge's internal Persona integration flag. Echoed for shape parity. No semantic here.
`has_accepted_terms_of_service`	boolean
`capabilities`	`{ payin_crypto, payout_crypto, payin_fiat, payout_fiat }` with values in `CapabilityState`
`endorsements`	array of `EndorsementResponse`
`requirements_due`	array of string	Actionable blockers right now.
`future_requirements_due`	array of string	Blockers that will surface as KYC progresses (e.g. need more docs at a higher tier).
`rejection_reasons`	array of `RejectionReason`
`associated_persons`	array of `{ id, email }`	Business only. Summary refs. Full objects via the Associated Persons endpoints.
`created_at`, `updated_at`	string (ISO 8601)

`CustomerStatus`

active
awaiting_questionnaire
awaiting_ubo
incomplete
not_started
offboarded
paused
rejected
under_review

`CapabilityState`

pending
active
inactive
rejected

`RejectionReason`

Field	Type	Notes
`developer_reason`	string	Machine-readable reason.
`reason`	string	Human-readable detail.