API reference / Access
GET
/v1/accessInspect key access
Returns key metadata, never the secret.
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/access' \
-H "Authorization: Bearer $BANKING_API_KEY"
const response = await fetch('https://api.bankmcp.app/v1/access', {
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
idstringrequirednamestringrequiredprefixstringrequiredpermissionsarray<"banks:read" | "accounts:read" | "balances:read" | "transactions:read" | "institutions:read" | "connections:create" | "banks:refresh" | "history:import" | "banks:disconnect" | "merchants:resolve" | "merchants:correct">requiredShow permissions schema
"banks:read" | "accounts:read" | "balances:read" | "transactions:read" | "institutions:read" | "connections:create" | "banks:refresh" | "history:import" | "banks:disconnect" | "merchants:resolve" | "merchants:correct"
resourcesobject | object | objectrequiredShow resources schema
Option 1: object
type"all"requiredOption 2: object
type"banks"requiredbank_idsarray<string>requiredShow bank_ids schema
string — Bank ID from list_banks, e.g. "DE:N26" (country code and bank name).
Option 3: object
type"accounts"requiredaccount_idsarray<string>requiredShow account_ids schema
string
created_atstringrequiredexpires_atstringrequiredlast_used_atstring | nullrequiredShow last_used_at schema
Option 1: string
string
Option 2: null
null
revoked_atstring | nullrequiredShow revoked_at schema
Option 1: string
string
Option 2: null
null
issued_bystring | nullrequiredShow issued_by schema
Option 1: string
string
Option 2: null
null
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 | STEP_UP_REQUIRED |
| 404 | NOT_FOUND |
| 409 | CONFLICT |
| 413 | REQUEST_TOO_LARGE |
| 429 | RATE_LIMITED |
| 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.