Get a customer by id
Fetch a single customer by id. Returns 404 if the customer does not exist, is archived, or belongs to an organization your credential cannot access. A customer you cannot access and one that does not exist return the same 404, so the API never confirms an id exists.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Narrow the request to one organization (Organization-Id selector).
Narrow the request to a connection's organization.
Narrow the request to a platform entity's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the customer.
Response
Kintsugi's unique identifier for the customer.
Organization the customer belongs to. Send it as the Organization-Id header to scope a write to this customer's organization.
Your stable identifier for the customer. null when the source system supplied none.
Human-facing identifier from the source system. null when the source has only externalId.
Customer name.
Registered or legal business name.
Contact email address.
Contact phone number.
Customer status. Reads never return archived customers, so this is always ACTIVE.
ACTIVEARCHIVEDHow far address validation got for this customer. UNVERIFIED until validation has run; BLANK when there is no address to validate.
UNVERIFIEDINVALIDPARTIALLY_VERIFIEDVERIFIEDUNVERIFIABLEBLANKBusiness registration number, or null when Kintsugi has not captured one for this customer.
Origin system of the customer (e.g. API, SHOPIFY). Any origin outside the published values is reported as OTHER.
ACUMATICAAIRWALLEXAMAZONAPIAPPLE_APP_STOREBESTBUYBIGCOMMERCEBILL_COMBUNNYCAMPFIRECHARGEBEECHECKOUTCHAMPDEELDUALENTRYEBAYECWIDETSYFACEBOOKFAIREFRESHBOOKSGOOGLE_APP_STOREGOOGLE_EXPRESSGROUPONGUSTOHYPERLINEINSTAGRAMINTUIT_ENTERPRISE_SUITEKICKSTARTERKILL_BILLMACYSMAGENTOMAXIOMERCADO_LIBREMICROSOFT_DYNAMICS_365MODALYSTNETSUITENEWEGGNOCNOCNORDSTROMODOOOPENMETERORBORDWAYOTHERPAYPALPINTERESTPLENTYONEQUICKBOOKSRECURLYRILLETRIPPLINGSAGE-INTACCTSALESFORCESHOPIFYSHOPLINESHOPWARESQUARESPACESTRIPETARGETTIKTOKVERTEX_O_SERIESWALMARTWAYFAIRWISHWIXWOOCOMMERCEXEROZENSKARZOHOZUORAConnection that produced the customer. null when the customer was not produced by a connection (e.g. created through this API).
First line of the street address. An empty string when none was supplied.
Second line of the street address. An empty string when none was supplied.
City or locality. An empty string when none was supplied.
County or district. An empty string when none was supplied.
State or province code.
Postal or ZIP code. An empty string when none was supplied.
Country code, ISO 3166-1 alpha-2.
The customer's tax registrations. An empty list when there are none.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.