# Get a customer by id

> GET /customers/{customer_id}

Source: https://docs.trykintsugi.com/reference/2026-07-21/get-a-customer-by-id

GET /customers/{customer_id}

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.

Category: Customers

Path parameters:
customer_id (string, required) - The unique identifier of the customer.

Response fields:
id (string, required) - Kintsugi's unique identifier for the customer.
organizationId (string, required) - Organization the customer belongs to. Send it as the `Organization-Id` header to scope a write to this customer's organization.
externalId (string) - Your stable identifier for the customer. `null` when the source system supplied none.
externalFriendlyId (string) - Human-facing identifier from the source system. `null` when the source has only externalId.
name (string) - Customer name.
companyName (string) - Registered or legal business name.
email (string) - Contact email address.
phone (string) - Contact phone number.
status (PublicCustomerStatusEnum, required) - Customer status. Reads never return archived customers, so this is always `ACTIVE`.
  allowed values: ACTIVE, ARCHIVED
addressStatus (PublicCustomerAddressStatusEnum, required) - How far address validation got for this customer. UNVERIFIED until validation has run; BLANK when there is no address to validate.
  allowed values: UNVERIFIED, INVALID, PARTIALLY_VERIFIED, VERIFIED, UNVERIFIABLE, BLANK
registrationNumber (string) - Business registration number, or `null` when Kintsugi has not captured one for this customer.
source (string, required) - Origin system of the customer (e.g. API, SHOPIFY). Any origin outside the published values is reported as OTHER.
  allowed values: ACUMATICA, AIRWALLEX, AMAZON, API, APPLE_APP_STORE, BESTBUY, BIGCOMMERCE, BILL_COM, BUNNY, CAMPFIRE, CHARGEBEE, CHECKOUTCHAMP (and 58 more, see the reference page)
connectionId (string) - Connection that produced the customer. `null` when the customer was not produced by a connection (e.g. created through this API).
street1 (string) - First line of the street address. An empty string when none was supplied.
street2 (string) - Second line of the street address. An empty string when none was supplied.
city (string) - City or locality. An empty string when none was supplied.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt