API reference / Accounts
/v1/accounts/{id}/transactionsList transactions
Requires transactions:read. Resource restrictions also apply. Read transactions.
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/accounts/RESOURCE_ID/transactions' \
-H "Authorization: Bearer $BANKING_API_KEY"
const response = await fetch('https://api.bankmcp.app/v1/accounts/RESOURCE_ID/transactions', {
headers: {
Authorization: `Bearer ${process.env.BANKING_API_KEY}`,
},
});
if (!response.ok) throw new Error(`Banking returned ${response.status}`);
const data = await response.json();
Parameters
idpathrequiredstring
date_fromqueryoptionalstring — Calendar date (YYYY-MM-DD)
date_toqueryoptionalstring — Calendar date (YYYY-MM-DD)
cursorqueryoptionalstring
limitqueryoptionalstring
Response
200 · application/json
environment"sandbox" | "production"requiredaccount_idstringrequiredretrieved_atstring | nullrequiredShow retrieved_at schema
Option 1: string
string
Option 2: null
null
source"stored" | "live"requiredcoverageobject | nullrequiredShow coverage schema
Option 1: object
fromstringrequiredCalendar date (YYYY-MM-DD)
tostringrequiredCalendar date (YYYY-MM-DD)
Option 2: null
null
transactionsarray<object>requiredShow transactions schema
idstringrequiredbooking_datestring | nullrequiredShow booking_date schema
Option 1: string
string — Calendar date (YYYY-MM-DD)
Option 2: null
null
value_datestring | nullrequiredShow value_date schema
Option 1: string
string — Calendar date (YYYY-MM-DD)
Option 2: null
null
amountobjectrequiredShow amount schema
amountstringrequiredExact decimal amount as a string
currencystringrequiredISO 4217 currency code
direction"CRDT" | "DBIT" | nullrequiredShow direction schema
Option 1: "CRDT" | "DBIT"
"CRDT" | "DBIT"
Option 2: null
null
descriptionarray<string>requiredShow description schema
string
counterpartystring | nullrequiredShow counterparty schema
Option 1: string
string
Option 2: null
null
statusstring | nullrequiredShow status schema
Option 1: string
string
Option 2: null
null
balance_after_transactionobject | nullrequiredThe account balance after this transaction, when the bank reports one.
Show balance_after_transaction schema
Option 1: object
amountstringrequiredExact decimal amount as a string
currencystringrequiredISO 4217 currency code
Option 2: null
null
merchantobject | nullrequiredShow merchant schema
Option 1: object
logo_urlstring | nullShow logo_url schema
Option 1: string
string
Option 2: null
null
namestringrequiredThe exact merchant name it is stored under (its logo is keyed by it).
kind"logo" | "category"requiredcategory"groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other"requiredbrandstring | nullrequiredShow brand schema
Option 1: string
string
Option 2: null
null
domainstring | nullrequiredShow domain schema
Option 1: string
string
Option 2: null
null
Option 2: null
null
category"groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other" | "transfer" | "income" | "fees" | "cash" | nullrequiredShow category schema
Option 1: "groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other" | "transfer" | "income" | "fees" | "cash"
"groceries" | "restaurant" | "coffee" | "fast_food" | "food_delivery" | "bar" | "bakery" | "pharmacy" | "health" | "beauty" | "fashion" | "electronics" | "home" | "shopping" | "software" | "subscription" | "music" | "streaming" | "entertainment" | "events" | "sports" | "fitness" | "travel" | "hotel" | "transport" | "taxi" | "fuel" | "parking" | "utilities" | "telecom" | "housing" | "insurance" | "education" | "books" | "pets" | "gifts" | "charity" | "government" | "other" | "transfer" | "income" | "fees" | "cash"
Option 2: null
null
viaobject | nullrequiredShow via schema
Option 1: object
providerstringrequiredThe wallet, e.g. PayPal.
role"funding" | "payment" | "transfer"requiredfunding: a bank debit that paid a wallet payment; payment: the wallet paying the merchant; transfer: between the wallet and a bank.
payeestring | nullrequiredFor funding: who the wallet paid (the merchant).
Show payee schema
Option 1: string
string
Option 2: null
null
linkedobject | nullrequiredShow linked schema
Option 1: object
idstringrequiredbankstringrequireddaystringrequiredCalendar date (YYYY-MM-DD)
amountstringrequiredExact decimal amount as a string
currencystringrequiredISO 4217 currency code
method"exact" | "amount_date" | "currency" | "partial"requiredconfidencenumberrequiredOption 2: null
null
Option 2: null
null
completebooleanrequirednext_cursorstring | nullrequiredShow next_cursor schema
Option 1: string
string
Option 2: null
null
continuation_instructionsstringwarningstringErrors
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.