---
title: "List account customers"
method: GET
path: "/accounts/{id}/customers"
tags: ["Customers"]
---

# List account customers

`GET /accounts/{id}/customers`

Get the customers associated with an account. Returns organization-level identity (nonprofit name, EIN, address).

## Path parameters

- `id` string, uuid, required

## Response `200`

The list of customers for the account

- CustomerListResponse — Paginated list of customers.
  - `page` Page — Pagination metadata for list responses.
    - `nextPageKey` string — Cursor token to retrieve the next page of results. Absent when there are no more results.
    - `totalElements` integer — Total number of elements across all pages
  - `customers` Customer[], required
    - `customerId` string, required — Unique identifier for the customer
    - `name` PersonName, required — A person's name.
      - `first` string
      - `middle` string
      - `last` string
      - `suffix` string
      - `prefix` string
      - `company` string
    - `taxId` string — Tax identification number (e.g., EIN)
    - `type` 'BUSINESS' | 'INDIVIDUAL', required — Type of customer
    - `addresses` AccountAddress[]
      - `line1` string, required
      - `line2` string
      - `line3` string
      - `city` string, required
      - `region` string, required — State or region code
      - `postalCode` string, required
      - `country` string, required — ISO 3166-1 alpha-2 country code
    - `businessCustomer` BusinessCustomer — Business customer information.
      - `name` string, required — Legal business name
      - `registeredId` string — Registered identifier (e.g., EIN)

## Other responses

- `401` — Missing or invalid OAuth 2.0 Bearer token
- `403` — Insufficient permissions or IP not whitelisted
- `404` — Resource not found
- `500` — Unexpected server error

---

[API](https://skmtc.net/chariot-giving/apis/chariot-fdx-api.md) · [All operations](https://skmtc.net/chariot-giving/apis/chariot-fdx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/chariot-fdx-api/versions/a5b23a590c8a/schema)
