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

# List account customers

`GET /accounts/{id}/customers`

## Request

- Base URL: `https://api.givechariot.com/fdx/v6`
- URL: `https://api.givechariot.com/fdx/v6/accounts/{id}/customers`
- Auth: OAuth 2
  - Authorization code: `https://dashboard.givechariot.com/oauth/authorize`
  - Token URL: `https://api.givechariot.com/auth/oauth/token`

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.dev/chariot-giving/apis/chariot-fdx-api.md) - [All operations](https://skmtc.dev/chariot-giving/apis/chariot-fdx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chariot-giving/apis/chariot-fdx-api/revisions/dbf5d377b683?raw)