Skip to content
Developers

API reference / Banks

POST/v1/banks/{id}/import-history

Import bank history

Requires history:import. Resource restrictions also apply. Import history.

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/import-history' \
  -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/import-history', {
  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

Option 1: object
status"complete"required
sincestring | nullrequired
Show since schema
Option 1: string

string — Calendar date (YYYY-MM-DD)

Option 2: null

null

messagestringrequired
Option 2: object
status"running"required
doneintegerrequired

Range: 0 – unbounded

totalintegerrequired

Range: 0 – unbounded

Option 3: object
status"consent_required"required
urlstringrequired

The bank's connect page in the portal: give it to the user to open.

bankobjectrequired
Show bank schema
namestringrequired
countrystring | nullrequired
Show country schema
Option 1: string

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

Option 2: null

null

psu_type"personal" | "business" | nullrequired
Show psu_type schema
Option 1: "personal" | "business"

"personal" | "business"

Option 2: null

null

optionsarray<object>
Show options schema
countrystringrequired

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

countriesarray<string>required
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

instructionsstringrequired
messagestringrequired

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.