Summary
The FDX API spec is a data exchange protocol for the financial services industry that is produced by the Financial Data Exchange non-profit organization.
Disclaimer
The FDX API spec documents are provided here as a convenience and for informational purposes only; they do not constitute an endorsement or approval of any of the content within.
Data/Information Disclosure
Per the first statement in the FDX API-Data Structures v4.1.pdf document:
FS-ISAC Traffic Light Protocol (TLP) Green:
Recipients may share TLP GREEN information with peers, trusted government and critical infrastructure partner organizations, and service providers with whom they have a contractual relationship, who have a need-to-know but not via publicly accessible channels.
Source: Traffic Light Protocol (TLP) Definitions and Usage
Inside of Jack Henry
This spec is something that we can freely share and discuss within Jack Henry.
Outside of Jack Henry
We must be careful not to share this spec outside of Jack Henry.
FDX Spec
Latest
FDX API v6.2 (Summer 2024 Release)
Archive (Old / Outdated)
FDX API v5.3.1 (Spring 2023 Release)
- FDX API Specification_v5.3.1.pdf
- FDX API Style Guide v5.3.pdf
- fdxapi.components.yaml
- fdxapi.consent.yaml
- fdxapi.core.yaml
- fdxapi.customer.yaml
- fdxapi.event-notifications.yaml
- fdxapi.fraud.yaml
- fdxapi.meta.yaml
- fdxapi.money-movement.yaml
- fdxapi.recipient-registration.yaml
- fdxapi.registry.yaml
- fdxapi.tax.yaml
Certification
- Certification Model for Data Providers v1.0.pdf
- Certification Requirements for Data Access Platforms v1.1.pdf
- Certification Requirements for Data Providers v1.0.pdf
- Certification Requirements for Data Recipients_v1.0.pdf
- Certification Use Cases Specification v 5.1.xlsx
- FDX Certification Use Cases v1.0.pdf
- FDX_Certfication_Scorecard v1.0.xlsx
Security
- Control Considerations for Consumer Financial Account Aggregation Services V3.3.pdf
- FDX API Security Model_v3.5.pdf
- FDX Recipient Registration Guidelines_v1.1.pdf
- FDX Recipient Registration with Delegation_v1.0.pdf
- FDX_Tax_Document_Alternate_Authentication_v2021.pdf
Tax
- FDX Tax Document QR Code Specification_v2020.0.pdf
- FDX_Tax_Document_Alternate_Authentication_v2021.pdf
- FDX_Tax_Document_PDF_Embedded_Data_v2021.pdf
User Experience
- Data Clusters Mapping File FDX v5.2.1.xlsx
- Data Minimization Guidelines v1.0.pdf
- FDX User Experience Guidelines v2.2.pdf
- Taxonomy of Permissioned Data Sharing v1.4.pdf
FDX API v5.0 (Oct 2021)
- FDX API v5.0 - Part I Specification Introduction.pdf
- FDX API v5.0 - Part II Core Specification.pdf
- FDX API v5.0 - Part III Tax Specification.pdf
- FDX API v5.0 - Part IV MoneyMovement Specification.pdf
- fdxapi.core.yaml
- fdxapi.money-movement.yaml
- fdxapi.tax.yaml
- fdxapi.yaml
Certification
- FDX_Certfication_Scorecard.xlsx
- Certification Model for Data Providers v1.0.pdf
- Foundational Requirements for Data Providers v1.0.pdf
Security
- Control Considerations for Consumer Financial Account Aggregation Services V3.3.pdf
- FDX Financial-Grade API Security Specification V3.4.pdf
- FDX_Tax_Document_Alternate_Authentication_v2021.pdf
Tax
- FDX Tax Document QR Code Specification_v2020.0.pdf
- FDX_Tax_Document_Alternate_Authentication_v2021.pdf
- FDX_Tax_Document_PDF_Embedded_Data_v2021.pdf
Use Case Documents
User Experience
4.5 (Dec 2020)
Introduction / Overview
Core API
- Core Specification - API Endpoints & Data Structures - PDF
- Core - OpenAPI Spec - YAML
- Core - OpenAPI Spec - YAML (for code generator tools)
Tax API
(Combined Spec - includes Core & Tax)
4.1 (April 2020)
- API Endpoints & Data Structures - PDF
- API Endpoints & Data Structures - Markdown
- OpenAPI Spec - YAML
- OpenAPI Spec - YAML (for code generator tools)
Data Mapping Tools
A few tools that are useful for mapping FDX to Banno’s API.
1) Technical Business Analysts’ spreadsheet
We have access to a Technical Business Analysts’ spreadsheet that can be helpful when mapping Account Categories to FDX Account Types.
2) Map (old) FDX 4.5 to Banno spreadsheet
We have used this mapping from an old version of FDX to Banno’s Consumer API with 3rd party devs who are interested in understanding how to map Banno to FDX: FDXv4.5_Banno-Data-Mapping-cleaned.xlsx
- FDX 4.5 was the latest and greatest version of FDX when we started the integration work with Akoya.
- As mentioned above, FDX 4.5 is old and should not be considered the source-of-truth, as-is, for any projects looking to map Banno to FDX…but it’s a good start!