Skip to content
Developers

API reference / Accounts

GET/v1/accounts

List accounts

Requires accounts:read. Resource restrictions also apply. Read account details.

Reads use stored data and do not refresh the bank.

Request examples

These examples use HTTP directly. Keep API keys on your server.

Shell
curl 'https://api.bankmcp.app/v1/accounts' \
  -H "Authorization: Bearer $BANKING_API_KEY"
TypeScript
const response = await fetch('https://api.bankmcp.app/v1/accounts', {
  headers: {
    Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
  },
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();

Parameters

bank_idqueryoptional

string — Bank ID from list_banks, e.g. "DE:N26" (country code and bank name).

include_closedqueryoptional

"true" | "false"

Response

200 · application/json

environment"sandbox" | "production"required
accountsarray<object>required
Show accounts schema
idstringrequired
bank_idstringrequired

Bank ID from list_banks, e.g. "DE:N26" (country code and bank name).

namestringrequired
productstring | nullrequired
Show product schema
Option 1: string

string

Option 2: null

null

bankobjectrequired
Show bank schema
namestringrequired
countrystringrequired

ISO 3166-1 alpha-2 country code, e.g. DE

currencystring | nullrequired
Show currency schema
Option 1: string

string

Option 2: null

null

iban_last4string | nullrequired
Show iban_last4 schema
Option 1: string

string

Option 2: null

null

closedbooleanrequired
consent_expires_atstringrequired
consent_expiredbooleanrequired

Errors

Errors contain error, code and an optional action. Read the error and retry guide.

StatusCode
400INVALID_INPUT
401INVALID_API_KEY
403INSUFFICIENT_PERMISSION
404NOT_FOUND
409CONFLICT
413REQUEST_TOO_LARGE
429rate_limit.feature
500REQUEST_FAILED
502INVALID_RESPONSE
503UNAVAILABLE

Try this request

Sent directly to https://api.bankmcp.app. Your key stays in this page’s memory and is never saved.

Query parameter

Query parameter