Skip to content
Developers

API reference / Banks

POST/v1/banks/{id}/refresh

Refresh a bank

Requires banks:refresh. Resource restrictions also apply. Refresh banks.

Requires whole-bank access. Work runs in the background; inspect the returned job state.

Request examples

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

Shell
curl -X POST 'https://api.bankmcp.app/v1/banks/RESOURCE_ID/refresh' \
  -H "Authorization: Bearer $BANKING_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{}'
TypeScript
const response = await fetch('https://api.bankmcp.app/v1/banks/RESOURCE_ID/refresh', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();

Parameters

idpathrequired

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

Request body

Content-Type: application/json

object

Response

200 · application/json

okbooleanrequired
warningstring

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

This sends a real action with your key’s permissions. Review the request before sending.