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.
curl 'https://api.bankmcp.app/v1/institutions/Example%20Bank' \
-H "Authorization: Bearer $BANKING_API_KEY"
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
namepathrequiredstring
Response
200 · application/json
institutionobjectrequiredShow institution schema
namestringrequiredoptionsarray<object>requiredShow options schema
countrystringrequiredCatalog entry the connection uses: the BIC's own country when listed.
countriesarray<string>requiredEvery market this option serves.
Show countries schema
string — ISO 3166-1 alpha-2 country code, e.g. DE
bicstring | nullrequiredShow bic schema
Option 1: string
string
Option 2: null
null
psu_typesarray<"personal" | "business">requiredShow psu_types schema
"personal" | "business"
betabooleanrequiredmaximum_consent_validitynumber | nullrequiredShow maximum_consent_validity schema
Option 1: number
number
Option 2: null
null
logo_urlstringErrors
Errors contain error, code and an optional action. Read the error and retry guide.
| Status | Code |
|---|---|
| 400 | INVALID_INPUT |
| 401 | INVALID_API_KEY |
| 403 | INSUFFICIENT_PERMISSION |
| 404 | NOT_FOUND |
| 409 | CONFLICT |
| 413 | REQUEST_TOO_LARGE |
| 429 | rate_limit.feature |
| 500 | REQUEST_FAILED |
| 502 | INVALID_RESPONSE |
| 503 | UNAVAILABLE |
Try this request
Sent directly to https://api.bankmcp.app. Your key stays in this page’s memory and is never saved.