POST
/
accounting
/
bankAccounts
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/bankAccounts \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "id": "5570042",
  "balance": 100,
  "bankName": "F. van Lanschot Bankiers",
  "bic": "SNSBNL2A",
  "currency": "EUR",
  "description": "Business Savings Account",
  "fileType": "CSV",
  "iban": "NL46INGB3591831883",
  "name": "Business Bank",
  "number": "0150",
  "system": "Internal",
  "status": "ACTIVE",
  "type": "GIRO"
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "5570042",
    "balance": 100,
    "bankName": "F. van Lanschot Bankiers",
    "bic": "SNSBNL2A",
    "createdDate": "2025-01-01T00:00:00Z",
    "currency": "EUR",
    "description": "Business Savings Account",
    "fileType": "CSV",
    "iban": "NL46INGB3591831883",
    "name": "Business Bank",
    "number": "0150",
    "system": "Internal",
    "status": "ACTIVE",
    "type": "GIRO",
    "updatedDate": "2025-02-01T00:00:00Z"
  }
}

Field support per integration

Headers

X-API-KEY
string
required

API key

X-ACCOUNT-KEY
string
required

Account key

Query Parameters

companyId
string
environmentName
string

Body

application/json
balance
number
bankName
string
bic
string
currency
enum<string>
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYR,
BZD,
CAD,
CDF,
CHF,
CLP,
CNY,
COP,
CRC,
CUC,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EEK,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GQE,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LTL,
LVL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MUR,
MVR,
MWK,
MXN,
MYR,
MZM,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VEB,
VND,
VUV,
WST,
XAF,
XCD,
XDR,
XOF,
XPF,
YER,
ZAR,
ZMK,
ZWR
description
string
fileType
enum<string>
Available options:
CSV,
MT940
iban
string
name
string
number
string
system
string
status
enum<string>
Available options:
ACTIVE,
ARCHIVED
type
enum<string>
Available options:
CREDIT_CARD,
GIRO,
PAYMENT_PROVIDER,
CURRENT_ASSET,
OTHER

Response

200 - application/json
meta
object
data
object