Sphere Partners
API architect explaining an integration approach to colleagues in a co-working library while planning an open banking API

Open Banking API: How Banks Build and Secure It

An open banking API is a secured interface that lets customer-approved third parties read account data or start payments at a bank or credit union. Banks build it as a consent-aware layer in front of the core, secured with OAuth 2.0 and FAPI controls, and run it with limits, monitoring and versioning.

11 min read
In this article

An open banking API is a secured, standardized interface that lets a customer's chosen app or provider read account data, or in some designs start a payment, at a bank or credit union, but only with the customer's consent. Building one means exposing core data through a consent-aware API layer, protecting it with OAuth 2.0 and FAPI-grade controls, and running it as a product with limits, monitoring and support.

This guide is for the teams that have to deliver it. It covers what the API exposes, where US regulation stands, how to design the API and the architecture behind it, a build sequence, how to secure and operate it, and when to build or buy. For the wider picture of bank systems, see our guide to banking software development.

What Is an Open Banking API and What Does It Expose?

An open banking API sits between a bank's internal systems and outside parties such as budgeting apps, lenders, accounting software and payment providers. The customer decides what to share and with whom, and the bank checks that consent on every call. In practice a bank publishes a small set of resources, and each one carries a different risk.

ResourceWhat it returns or doesMain design concern
AccountsAccount type, status and masked identifiersShare a tokenized identifier instead of the full account number wherever the use case allows
BalancesCurrent and available balanceServe from a replica so balance checks do not load the core
TransactionsPosted and pending items with dates and descriptionsPagination and date windows, so one request cannot pull years of history
Payment initiationA customer-authorized request to move moneyIdempotency keys and strong authentication; this is the highest-risk resource
Identity and ownershipName, address and account-ownership confirmationData minimization: return only the fields the use case needs
ConsentGrant, scope, expiry and revocation recordsThe audit record that proves what the customer allowed

Most banks start with read-only resources (accounts, balances and transactions) and add payment initiation later, because writes bring fraud and liability questions that reads do not.

Is an Open Banking API Required for US Banks and Credit Unions?

The US answer comes from the CFPB's personal financial data rights rule, issued in October 2024 under Section 1033 of the Dodd-Frank Act. The rule requires covered data providers to make consumer financial data available to consumers and to authorized third parties through secure, standardized interfaces. In August 2025 the CFPB published a notice as part of its reconsideration of the rule (opens in new tab), so its scope and compliance dates are still being set.

For engineers, the practical answer is to build what survives any outcome: consent-based access, scoped data, no credential sharing and a documented, secured interface. Many US institutions also look to the Financial Data Exchange (FDX), an industry standards body whose FDX API (opens in new tab) is a common data-sharing specification, listed at version 6.4 in its Spring 2025 release, as the model for resource and field design. A published standard also saves third parties from writing a custom integration for every bank.

How Do Banks Design an Open Banking API?

Design starts from the consumer of the API, not from the core's data model. A core system stores data the way it was built decades ago, while a third party needs stable, documented resources. Five decisions shape the result:

  • Adopt a standard data model. Map your core's fields to a published model such as FDX instead of inventing your own, and keep that mapping in one place.
  • Make consent a first-class object. Every call carries a token tied to a consent record with scopes, an expiry and a revocation path the customer can reach.
  • Version from day one. Put the version in the path or a header, publish a deprecation policy and never change the meaning of a field inside a version.
  • Design for retries. Payment and other write calls need idempotency keys so a timeout never moves money twice.
  • Standardize errors and limits. Return consistent error codes and rate-limit headers so third-party developers can fix problems without opening support tickets.

These decisions are quick to make before launch and slow to change once third parties have integrated. They also make the API easier to test, which helps when an examiner asks how a field is derived.

What Architecture Sits Behind a Bank's Open Banking API?

A safe design never lets third-party traffic reach the core directly. The usual layout has five parts:

  • API gateway. Terminates TLS, authenticates the calling client, enforces per-client rate limits and routes requests.
  • Authorization server and consent service. Issues tokens, records what the customer approved and checks it on each call.
  • Domain APIs. Small services for accounts, transactions, payments and identity that translate between the standard model and internal systems.
  • Data layer. A read-optimized store or cache fed from the core, so balance and transaction queries do not add load to the system of record.
  • Audit and observability. Immutable logs of every access, plus metrics and traces per client.

This is the same pattern banks use in digital transformation in banking: new capabilities sit around the core and talk to it through controlled integration points. Where the core is old, the API layer becomes the first step of a staged legacy system modernization, because consumers then depend on the interface instead of on the core's internals. The systems integration work inside that layer, which means adapters, event feeds and reconciliation, is usually where most of the effort goes.

Small, independently deployable services also make change safer. In a fintech transaction portal that Sphere rebuilt on microservices, hotfixes that used to take days are now deployed in hours, according to the published case study.

How Do You Build an Open Banking API, Step by Step?

Banks that ship on schedule treat the API as a product with a release plan, not as a one-off integration. A workable sequence looks like this:

From scope to production

  1. 1Scope the use cases and dataPick the first consumers and the minimum resources they need. List the data classes involved and who may receive them.
  2. 2Define the contractWrite the OpenAPI specification, map fields to the standard and agree error and versioning rules before any code.
  3. 3Build the consent and security layerStand up the authorization server, consent service and gateway policies first, so every endpoint inherits them.
  4. 4Implement domain APIs and the data layerConnect to the core and other systems through adapters, add the read store and reconcile balances against the source.
  5. 5Test in a sandboxPublish a sandbox with synthetic data and contract tests, then run security and load tests that mimic real client behavior.
  6. 6Onboard and release in stagesAdmit a few vetted third parties, watch live traffic, then widen access with rollback ready.
  7. 7Operate and evolveTrack usage and errors per client, rotate keys, patch dependencies and run the deprecation policy.

Building the security layer before the endpoints is the point most teams get wrong. Security retrofitted onto working endpoints leaves gaps, while security inherited from the gateway and authorization server does not.

How Do You Secure an Open Banking API?

Open banking APIs expose financial data to outside parties, so authorization carries most of the security weight. The baseline is OAuth 2.0 with the authorization code flow, hardened by the OpenID Foundation's FAPI 2.0 Security Profile (opens in new tab), a final standard for high-value APIs. It requires pushed authorization requests, PKCE with the S256 method and sender-constrained access tokens using either mutual TLS or DPoP. Clients authenticate with mutual TLS or private_key_jwt, TLS 1.2 or later is required and the password grant is out.

A profile alone does not secure the system. The table maps common threats to the controls that address them and shows where each control lives.

ThreatControlWhere it lives
Stolen or replayed access tokenSender-constrained tokens and short lifetimesAuthorization server
Over-broad data sharingGranular scopes tied to consent, plus field-level minimizationConsent service and domain APIs
Abusive or runaway clientPer-client rate limiting and quotasAPI gateway
One customer's data returned to another's clientAn ownership check on every request, tested automaticallyDomain APIs
Untrusted third partyVetting, registered keys and certificates, fast revocationOnboarding process
Undetected misuseImmutable access logs and anomaly alertsAudit and observability

The ownership-check row deserves emphasis. Object-level authorization flaws are a common API weakness, and they are found by automated tests, not by reading a security profile.

Build these checks into delivery. A DevSecOps pipeline runs dependency scans, static analysis and authorization tests on every change and keeps the results as audit evidence, and an independent code audit before launch gives a second view of the riskiest paths. Data location needs a decision early too, and our article on data residency in banking covers how to keep regulated data inside the boundary you choose.

How Do Banks Operate an Open Banking API After Launch?

Launch is the start of the operating work. Third parties build products on your API, so an outage or a silent change becomes their incident. Four practices matter most:

  • Service levels and visibility. Publish availability and latency targets and monitor them per client, so you can tell a platform fault from one client's bug.
  • A developer portal and sandbox. Documentation, sample calls and test data reduce the volume of support requests.
  • Change control. Announce deprecations early, run old and new versions in parallel and keep contract tests in the pipeline so a refactor cannot break a field.
  • Incident and consent operations. Keep a runbook to revoke a client's access quickly and notify affected customers, and let customers see and revoke their own consents.

These are also the habits fintech teams expect from a data provider. For the partner side of the relationship, see our guide to fintech software development.

Should a Bank Build or Buy Its Open Banking API?

Most banks do both. Vendors sell API gateways, consent management and developer portals, and some core and digital banking vendors ship open banking modules. What the bank still owns is the mapping from its own systems to the standard, the quality of the data behind it and the operating model. Before you buy, check three things: whether the product supports the standard and security profile you need, how it reads from your core without adding load, and who maintains the mapping when the core changes.

Where products stop, custom work fills the gap: adapters, reconciliation, consent screens that match your brand and the connections between systems. That is the work our custom software engineering team delivers. Scope and investment are defined with each client after reviewing the systems involved.

Plan an open banking API your security team can approve

Sphere helps banks and credit unions design, build and secure the integration layer around the core, with controls your compliance team can review.

Frequently Asked Questions

Frequently asked questions

An open banking API is a secured interface that lets a customer-approved third party, such as a budgeting app or lender, read account data or start a payment at a bank or credit union. Access depends on the customer's consent, which the bank checks on every request through tokens, scopes and a consent record.

The customer approves access in the bank's own consent screen. The bank's authorization server then issues a token limited to the approved scopes. The third party calls the API with that token, and the gateway checks the token, the consent and rate limits before domain services return data from the bank's systems.

They can be, when built on OAuth 2.0 with a hardened profile such as FAPI 2.0, which requires pushed authorization requests, PKCE and sender-constrained tokens. Security also depends on scoped consent, per-client rate limiting, ownership checks on every request, vetted third parties and access logs that can be audited.

Many US institutions look to the FDX API as the data model and to OAuth 2.0 with the FAPI 2.0 profile for security. These are voluntary industry and open standards. The CFPB's personal financial data rights rule, which is under reconsideration, sets the regulatory direction in the US.

Not entirely. Banks usually buy components such as the gateway, consent management and developer portal, then build the mapping from core and other systems to the standard, the data layer and the operating processes. The right split depends on how well the vendor product fits your core and your security requirements.

Related posts

We'd love to hear from you!

Please provide your contact details, and our team will get back to you promptly.