> 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 accounts

GET https://api.givechariot.com/fdx/v6/accounts

Search and retrieve customer deposit accounts.

Chariot is a financial technology company, not a bank. Chariot Accounts come with a Demand Deposit Account through our banking services partner, Column N.A., Member FDIC.

Reference: https://docs.givechariot.com/fdx/accounts/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

### Query parameters

- `limit` (integer, optional, default: 10) — Number of results per page. Clamped to the range 10–100.
- `pageKey` (string, optional) — Cursor token for pagination. Pass the `nextPageKey` value from a previous response.

## Response

### 200

A paginated list of deposit accounts

- `accounts` (list of DepositAccount, required)
- `organizationId` (string, optional) — The organization that owns the accounts. Equivalent to the customerId returned by GET /customers/current.
- `page` (Page, optional) — Pagination metadata for list responses.

## Errors

### 400 Bad Request Error

Invalid request parameters

- `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

### 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

### 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

### DepositAccount

A deposit (bank) account. Chariot is a financial technology company, not a bank. Chariot Accounts come with a Demand Deposit Account through our banking services partner, Column N.A., Member FDIC.

- `accountCategory` (enum, required) — Category of account
  - Allowed values: `DEPOSIT_ACCOUNT`
- `accountType` (enum, required) — Type of deposit account
  - Allowed values: `CHECKING`
- `accountId` (string, required) — Unique identifier for the account
- `accountNumber` (string, required) — Full account number
- `accountNumberDisplay` (string, required) — Masked or truncated account number for display
- `productName` (string, required) — Product name for the account
- `currency` (Currency, required) — Currency information.
- `status` (enum, required) — Status of the account
  - Allowed values: `OPEN`, `CLOSED`, `DELINQUENT`, `NEGATIVECURRENTBALANCE`, `PAID`, `PENDINGCLOSE`, `PENDINGOPEN`, `RESTRICTED`
- `accountOpenDate` (date, required) — Date the account was opened (YYYY-MM-DD)
- `nickName` (string, optional) — User-assigned nickname for the account
- `nickname` (string, optional) — Alternate nickname field
- `description` (string, optional) — Description of the account
- `accountCloseDate` (date, optional) — Date the account was closed (YYYY-MM-DD). Present only for closed accounts.

### 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

### Currency

Currency information.

- `currencyCode` (string, required) — ISO 4217 currency code

## Examples

**Response**

```json
{
  "accounts": [
    {
      "accountCategory": "DEPOSIT_ACCOUNT",
      "accountType": "CHECKING",
      "accountId": "string",
      "accountNumber": "string",
      "accountNumberDisplay": "string",
      "productName": "string",
      "currency": {
        "currencyCode": "USD"
      },
      "status": "OPEN",
      "accountOpenDate": "2023-01-15",
      "nickName": "string",
      "nickname": "string",
      "description": "string",
      "accountCloseDate": "2023-01-15"
    }
  ],
  "organizationId": "string",
  "page": {
    "nextPageKey": "string",
    "totalElements": 1
  }
}
```