# List customers

> GET /customers

Source: https://docs.trykintsugi.com/reference/2026-07-21/list-customers

GET /customers

List customers

List customers, keyset-paginated. Covers every organization your credential can access; pass an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to narrow to one. Pass `limit` and the opaque `cursor` from a prior response's `nextCursor` or `previousCursor` to page; Archived customers are excluded. `hasMore` and `hasPrevious` report whether a page exists that way. A cursor is only valid for the sort, the filters AND the organization scope it was issued under, including any selector header: change any of them and start again from the first page.

Category: Customers

Query parameters:
sort (PublicCustomerSortEnum) - Field to sort by. `createdAt` is the default and is dramatically faster on large organizations; the other keys sort the whole matching set.
  allowed values: createdAt, name, street1, city, state, postalCode, country, status
order (PublicCustomerSortOrder) - Sort direction. Defaults to `desc`, so newest first.
  allowed values: asc, desc
search (string) - Search over customer id, name, email, externalId and externalFriendlyId. id, externalId and externalFriendlyId must match exactly; name and email match a case-insensitive substring.
country (string) - Comma-separated ISO 3166-1 alpha-2 country codes; matches any of them.
state (string) - Comma-separated state or province codes; matches any of them.
source (string) - Comma-separated source systems; matches any of them.
connectionId (string) - Comma-separated connection ids; matches any of them. This filters rows by connection. To restrict which organization is read, send the `Connection-Id` header instead.
limit (integer) - Maximum number of items to return.
cursor (string) - Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response fields:
items (Customer[], required) - The customers on this page.
  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.
[truncated, see the reference page]

---

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