> This page is for version v2026-04-01 (default).
> For other versions, use one of these documentation indexes:
> - v2026-04-01 (default): https://docs.givechariot.com/v2026-04-01/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.givechariot.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.givechariot.com/_mcp/server.

# List account customers

GET https://api.givechariot.com/fdx/v6/accounts/{id}/customers

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

Reference: https://docs.givechariot.com/fdx/customers/list

## Authentication

- `Authorization` header (bearer token, required) — OAuth 2.0 Bearer token. The FDX API is read-only and requires the read_only scope. See the Authentication page for token exchange details.

## Servers

- `https://api.givechariot.com/fdx/v6` (Production, default)
- `https://devapi.givechariot.com/fdx/v6` (Staging)

## Request

### Path parameters

- `id` (string, required) — Unique identifier for the account

## Response

### 200

The list of customers for the account

- `customers` (list of Customer, required)
- `page` (Page, optional) — Pagination metadata for list responses.

## Errors

### 401 Unauthorized Error

Missing or invalid OAuth 2.0 Bearer token

- `type` (string, required) — A URI reference that identifies the problem type
- `title` (string, required) — A short human-readable summary of the problem type
- `status` (integer, required) — The HTTP status code
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem

### 403 Forbidden Error

Insufficient permissions or IP not whitelisted

- `type` (string, required) — A URI reference that identifies the problem type
- `title` (string, required) — A short human-readable summary of the problem type
- `status` (integer, required) — The HTTP status code
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem

### 404 Not Found Error

Resource not found

- `type` (string, required) — A URI reference that identifies the problem type
- `title` (string, required) — A short human-readable summary of the problem type
- `status` (integer, required) — The HTTP status code
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem

### 500 Internal Server Error

Unexpected server error

- `type` (string, required) — A URI reference that identifies the problem type
- `title` (string, required) — A short human-readable summary of the problem type
- `status` (integer, required) — The HTTP status code
- `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem
- `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem

## Types

### Customer

A customer (organization) associated with an account.

- `customerId` (string, required) — Unique identifier for the customer
- `name` (PersonName, required) — A person's name.
- `type` (enum, required) — Type of customer
  - Allowed values: `BUSINESS`, `INDIVIDUAL`
- `taxId` (string, optional) — Tax identification number (e.g., EIN)
- `addresses` (list of AccountAddress, optional)
- `businessCustomer` (BusinessCustomer, optional) — Business customer information.

### Page

Pagination metadata for list responses.

- `nextPageKey` (string, optional) — Cursor token to retrieve the next page of results. Absent when there are no more results.
- `totalElements` (integer, optional) — Total number of elements across all pages

### PersonName

A person's name.

- `first` (string, optional)
- `middle` (string, optional)
- `last` (string, optional)
- `suffix` (string, optional)
- `prefix` (string, optional)
- `company` (string, optional)

### AccountAddress

A postal address.

- `line1` (string, required)
- `city` (string, required)
- `region` (string, required) — State or region code
- `postalCode` (string, required)
- `country` (string, required) — ISO 3166-1 alpha-2 country code
- `line2` (string, optional)
- `line3` (string, optional)

### BusinessCustomer

Business customer information.

- `name` (string, required) — Legal business name
- `registeredId` (string, optional) — Registered identifier (e.g., EIN)

## Examples

**Response**

```json
{
  "customers": [
    {
      "customerId": "string",
      "name": {
        "first": "string",
        "middle": "string",
        "last": "string",
        "suffix": "string",
        "prefix": "string",
        "company": "string"
      },
      "type": "BUSINESS",
      "taxId": "string",
      "addresses": [
        {
          "line1": "string",
          "city": "string",
          "region": "string",
          "postalCode": "string",
          "country": "string",
          "line2": "string",
          "line3": "string"
        }
      ],
      "businessCustomer": {
        "name": "string",
        "registeredId": "string"
      }
    }
  ],
  "page": {
    "nextPageKey": "string",
    "totalElements": 1
  }
}
```