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

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

Get a paginated list of transactions for an account. When specifying a date range, both startTime and endTime must be provided together. Defaults to the last 7 days if no date range is specified. Data is available for up to 24 months from the current date.

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

### 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.
- `startTime` (date, optional) — Start date for filtering results (inclusive). Format: YYYY-MM-DD. Must be specified together with endTime or omitted entirely.
- `endTime` (date, optional) — End date for filtering results (inclusive). Format: YYYY-MM-DD. Must be specified together with startTime or omitted entirely.

## Response

### 200

A paginated list of transactions

- `transactions` (list of DepositTransaction, required)
- `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

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

### DepositTransaction

A deposit account transaction. 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`
- `accountId` (string, required) — The account this transaction belongs to
- `transactionId` (string, required) — Unique identifier for the transaction
- `transactionTimestamp` (datetime, required) — Timestamp when the transaction occurred
- `description` (string, required) — Description of the transaction
- `debitCreditMemo` (enum, required) — Whether the transaction is a debit or credit
  - Allowed values: `DEBIT`, `CREDIT`
- `status` (enum, required) — Status of the transaction
  - Allowed values: `PENDING`, `POSTED`, `AUTHORIZATION`, `MEMO`
- `amount` (double, required) — Transaction amount
- `postedTimestamp` (datetime, optional) — Timestamp when the transaction was posted
- `memo` (string, optional) — Additional memo text
- `category` (string, optional) — Transaction category
- `subCategory` (string, optional) — Transaction sub-category
- `lineItem` (list of LineItem, optional)
- `reward` (TransactionReward, optional) — Reward information associated with a transaction.
- `reference` (string, optional) — Reference identifier for the transaction
- `links` (list of Link, optional)
- `fiAttributes` (list of FiAttribute, optional)
- `transactionType` (enum, optional) — Type of deposit transaction
  - Allowed values: `ADJUSTMENT`, `ATMDEPOSIT`, `ATMWITHDRAWAL`, `BILLPAYMENT`, `CHECK`, `DEPOSIT`, `DIRECTDEPOSIT`, `DIVIDEND`, `FEE`, `INTEREST`, `POSCREDIT`, `POSDEBIT`, `PREAUTHORIZEDDEPOSIT`, `PREAUTHORIZEDWITHDRAWAL`, `TRANSFER`, `WITHDRAWAL`
- `payee` (string, optional) — Payee name
- `checkNumber` (integer, optional) — Check number if applicable

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

### LineItem

A line item within a transaction.

- `description` (string, optional)
- `amount` (double, optional)
- `checkNumber` (integer, optional)
- `memo` (string, optional)
- `reference` (string, optional)

### TransactionReward

Reward information associated with a transaction.

- `categoryId` (string, optional)
- `accrued` (double, optional)
- `adjusted` (double, optional)

### Link

A hyperlink reference.

- `href` (string, required) — URI of the linked resource

### FiAttribute

A financial institution-specific attribute.

- `name` (string, required)
- `value` (string, required)

## Examples

**Response**

```json
{
  "transactions": [
    {
      "accountCategory": "DEPOSIT_ACCOUNT",
      "accountId": "string",
      "transactionId": "string",
      "transactionTimestamp": "2024-01-15T09:30:00Z",
      "description": "string",
      "debitCreditMemo": "DEBIT",
      "status": "PENDING",
      "amount": 1.1,
      "postedTimestamp": "2024-01-15T09:30:00Z",
      "memo": "string",
      "category": "string",
      "subCategory": "string",
      "lineItem": [
        {
          "description": "string",
          "amount": 1.1,
          "checkNumber": 1,
          "memo": "string",
          "reference": "string"
        }
      ],
      "reward": {
        "categoryId": "string",
        "accrued": 1.1,
        "adjusted": 1.1
      },
      "reference": "string",
      "links": [
        {
          "href": "string"
        }
      ],
      "fiAttributes": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "transactionType": "ADJUSTMENT",
      "payee": "string",
      "checkNumber": 1
    }
  ],
  "page": {
    "nextPageKey": "string",
    "totalElements": 1
  }
}
```