API reference / Banks
GET
/v1/banksList connected banks
Requires banks:read. Resource restrictions also apply. List connected 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/banks' \
-H "Authorization: Bearer $BANKING_API_KEY"
const response = await fetch('https://api.bankmcp.app/v1/banks', {
headers: {
Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
},
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();
Response
200 · application/json
banksarray<object>requiredShow banks schema
bank_idstringrequiredBank ID from list_banks, e.g. "DE:N26" (country code and bank name).
namestringrequiredcountrystringrequiredISO 3166-1 alpha-2 country code, e.g. DE
Errors
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.