Skip to main content
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": 125,
      "perPage": 50,
      "currentPage": 1,
      "totalPages": 3
    }
  },
  "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

Supported Request Parameters:
​
balance
number
required
​
bankName
string
required
​
bic
string
Required if type equals GIRO.
​
currency
enum
Available options (3-letter ISO 4217):
EUR
​
iban
string
required
Required if type equals GIRO.
​
name
string
required
​
system
string
required
​
type
string
required
Available options: GIRO, PAYMENT_PROVIDER
This endpoints allows the creation of both “file import accounts” and “clearing accounts”. To create “file import accounts”, set the type equal to PAYMENT_PROVIDER. In such case, the fileType field is required. To create “clearing accounts” set the type equal to CURRENT_ASSET.
Supported Request Parameters:
​
iban
string
​
fileType
string
Available options: CSV, MT940,
​
name
string
required
​
number
string
​
type
string
required
Available options: PAYMENT_PROVIDER, CURRENT_ASSET

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
Example:
{
  "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"
}