Skip to content
Developers

API reference / Institutions

GET/v1/institutions/{name}

Get an institution

Requires institutions:read. Resource restrictions also apply. Search supported banks.

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/institutions/Example%20Bank' \
  -H "Authorization: Bearer $BANKING_API_KEY"
TypeScript
const response = await fetch('https://api.bankmcp.app/v1/institutions/Example%20Bank', {
  headers: {
    Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
  },
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();

Parameters

namepathrequired

string

Response

200 · application/json

institutionobjectrequired
Show institution schema
namestringrequired
optionsarray<object>required
Show options schema
countrystringrequired

Catalog entry the connection uses: the BIC's own country when listed.

countriesarray<string>required

Every market this option serves.

Show countries schema

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

bicstring | nullrequired
Show bic schema
Option 1: string

string

Option 2: null

null

psu_typesarray<"personal" | "business">required
Show psu_types schema

"personal" | "business"

betabooleanrequired
maximum_consent_validitynumber | nullrequired
Show maximum_consent_validity schema
Option 1: number

number

Option 2: null

null

logo_urlstring

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.

Resource identifier