Overview

FDX API

Financial Data Exchange v6 API for bank data aggregation

The Chariot FDX API implements the Financial Data Exchange (FDX) v6 standard, providing read-only access to bank account data for authorized financial data aggregators.

Overview

The FDX API exposes 7 read-only endpoints organized around deposit accounts:

CategoryEndpointsDescription
AccountsList accounts, Get account, Get contactAccount information, balances, and contact details
StatementsList statements, Get statement documentStatement metadata and document downloads (PDF, CSV, BAI2)
CustomersList customersOrganization identity associated with an account
TransactionsList transactionsTransaction history with pagination and date filtering

Base URL

EnvironmentBase URL
Productionhttps://api.givechariot.com/fdx/v6
Staginghttps://devapi.givechariot.com/fdx/v6

Key Concepts

Pagination

List endpoints support cursor-based pagination using pageKey (a UUID cursor) and limit (10–100 results per page). The response includes a page object with nextPageKey when more results are available.

Date Filtering

The statements and transactions endpoints support date range filtering via startTime and endTime query parameters (format: YYYY-MM-DD). Both must be specified together or both omitted. When omitted, defaults to the last 7 days.

Data is available for up to 24 months from the current date. Requests with a startTime older than 24 months will return data starting from the 24-month boundary.

Content Negotiation

The statement document endpoint supports multiple formats via the Accept header:

  • application/pdf (default)
  • text/csv
  • application/vnd.bai2

Error Format

All errors follow the RFC 7807 Problem Details standard with content type application/problem+json.