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

# Get account

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

Get account balances, liabilities, and other detailed account information for a single deposit 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.

Reference: https://docs.givechariot.com/fdx/accounts/get

## 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 deposit account details including balances

- `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)
- `currentBalance` (double, required) — Current balance of the account
- `availableBalance` (double, required) — Available balance of the account
- `routingTransitNumber` (string, required) — Routing transit number (RTN) for the account
- `balanceType` (enum, required) — Type of balance
  - Allowed values: `ASSET`
- `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.
- `balanceAsOf` (datetime, optional) — Timestamp of when the balance was calculated
- `lineOfBusiness` (string, optional) — Line of business for the account
- `interestRate` (double, optional) — Interest rate for the account
- `transferIn` (boolean, optional) — Whether the account supports incoming transfers
- `transferOut` (boolean, optional) — Whether the account supports outgoing transfers

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

### Currency

Currency information.

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

## Examples

**Response**

```json
{
  "accountCategory": "DEPOSIT_ACCOUNT",
  "accountType": "CHECKING",
  "accountId": "string",
  "accountNumber": "string",
  "accountNumberDisplay": "string",
  "productName": "string",
  "currency": {
    "currencyCode": "USD"
  },
  "status": "OPEN",
  "accountOpenDate": "2023-01-15",
  "currentBalance": 1.1,
  "availableBalance": 1.1,
  "routingTransitNumber": "string",
  "balanceType": "ASSET",
  "nickName": "string",
  "nickname": "string",
  "description": "string",
  "accountCloseDate": "2023-01-15",
  "balanceAsOf": "2024-01-15T09:30:00Z",
  "lineOfBusiness": "string",
  "interestRate": 1.1,
  "transferIn": true,
  "transferOut": true
}
```