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

  1. 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.
  2. In Postman, choose Import and provide the OpenAPI definition (file or URL).
  3. 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:read for reads, banking:write for create and update, and banking:admin for 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:

EnvironmentBase URL
Sandboxhttps://api.sandbox.astrada.co
Productionhttps://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.


Did this page help you?