Banking API in Postman
Overview
The Banking API lets you connect bank accounts (via Plaid), sync bank transactions, and reconcile them against card transactions. The full surface (bank links, bank accounts, bank subscriptions, bank transactions, and transaction matches) is published as an OpenAPI definition you can import into Postman to get a ready-to-run collection.
The collection is generated from the same OpenAPI definition that backs the API reference, so the two always match. There is no hand-maintained collection to drift out of date.
Import into Postman
- Copy the address of the Banking API's OpenAPI definition:
https://docs.astrada.co/openapi/astrada-banking.json. To work from a file, open any Banking API page of the API reference and use the download icon beside its title. - In Postman, choose Import and provide the OpenAPI definition (file or URL).
- Postman generates a collection with one folder per resource (Bank Links, Bank Accounts, Bank Subscriptions, Bank Transactions, Transaction Matches), including request examples pulled from the spec.
Authentication
Every request needs an OAuth2 bearer token (Authentication shows how to get one):
Authorization: Bearer <access-token>
- Account context is derived from the token: its issuer carries your
accountId. There is no separate account header. - Scopes:
banking:readfor reads,banking:writefor create and update, andbanking:adminfor deletes, sync, backfill, maintenance, re-sending webhooks and every bank subscription read.
In Postman, set a collection or environment variable (e.g. bearerToken) and use it as a Bearer token so every request inherits it.
Base URLs
Point Postman's baseUrl variable at the environment you're targeting:
| Environment | Base URL |
|---|---|
| Sandbox | https://api.sandbox.astrada.co |
| Production | https://api.astrada.co |
The OpenAPI definition names the sandbox as its only server, so an imported collection starts on the sandbox, and Try It on the Banking reference pages calls the sandbox too. To call production, set baseUrl to https://api.astrada.co and use a production token.
Updated 4 minutes ago
