Create bank account

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 '
{
  "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"
}
'

import requests

url = "https://api.maesn.dev/accounting/bankAccounts"

payload = {
    "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"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<x-api-key>',
    'X-ACCOUNT-KEY': '<x-account-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.maesn.dev/accounting/bankAccounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/bankAccounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/bankAccounts"

	payload := strings.NewReader("{\n  \"balance\": 100,\n  \"bankName\": \"F. van Lanschot Bankiers\",\n  \"bic\": \"SNSBNL2A\",\n  \"currency\": \"EUR\",\n  \"description\": \"Business Savings Account\",\n  \"fileType\": \"CSV\",\n  \"iban\": \"NL46INGB3591831883\",\n  \"name\": \"Business Bank\",\n  \"number\": \"0150\",\n  \"system\": \"Internal\",\n  \"status\": \"ACTIVE\",\n  \"type\": \"GIRO\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/bankAccounts")
  .header("X-API-KEY", "<x-api-key>")
  .header("X-ACCOUNT-KEY", "<x-account-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"balance\": 100,\n  \"bankName\": \"F. van Lanschot Bankiers\",\n  \"bic\": \"SNSBNL2A\",\n  \"currency\": \"EUR\",\n  \"description\": \"Business Savings Account\",\n  \"fileType\": \"CSV\",\n  \"iban\": \"NL46INGB3591831883\",\n  \"name\": \"Business Bank\",\n  \"number\": \"0150\",\n  \"system\": \"Internal\",\n  \"status\": \"ACTIVE\",\n  \"type\": \"GIRO\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/bankAccounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"balance\": 100,\n  \"bankName\": \"F. van Lanschot Bankiers\",\n  \"bic\": \"SNSBNL2A\",\n  \"currency\": \"EUR\",\n  \"description\": \"Business Savings Account\",\n  \"fileType\": \"CSV\",\n  \"iban\": \"NL46INGB3591831883\",\n  \"name\": \"Business Bank\",\n  \"number\": \"0150\",\n  \"system\": \"Internal\",\n  \"status\": \"ACTIVE\",\n  \"type\": \"GIRO\"\n}"

response = http.request(request)
puts response.read_body

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

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 '
{
  "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"
}
'

import requests

url = "https://api.maesn.dev/accounting/bankAccounts"

payload = {
    "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"
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "X-ACCOUNT-KEY": "<x-account-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-API-KEY': '<x-api-key>',
    'X-ACCOUNT-KEY': '<x-account-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.maesn.dev/accounting/bankAccounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.maesn.dev/accounting/bankAccounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-ACCOUNT-KEY: <x-account-key>",
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.maesn.dev/accounting/bankAccounts"

	payload := strings.NewReader("{\n  \"balance\": 100,\n  \"bankName\": \"F. van Lanschot Bankiers\",\n  \"bic\": \"SNSBNL2A\",\n  \"currency\": \"EUR\",\n  \"description\": \"Business Savings Account\",\n  \"fileType\": \"CSV\",\n  \"iban\": \"NL46INGB3591831883\",\n  \"name\": \"Business Bank\",\n  \"number\": \"0150\",\n  \"system\": \"Internal\",\n  \"status\": \"ACTIVE\",\n  \"type\": \"GIRO\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<x-api-key>")
	req.Header.Add("X-ACCOUNT-KEY", "<x-account-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.maesn.dev/accounting/bankAccounts")
  .header("X-API-KEY", "<x-api-key>")
  .header("X-ACCOUNT-KEY", "<x-account-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"balance\": 100,\n  \"bankName\": \"F. van Lanschot Bankiers\",\n  \"bic\": \"SNSBNL2A\",\n  \"currency\": \"EUR\",\n  \"description\": \"Business Savings Account\",\n  \"fileType\": \"CSV\",\n  \"iban\": \"NL46INGB3591831883\",\n  \"name\": \"Business Bank\",\n  \"number\": \"0150\",\n  \"system\": \"Internal\",\n  \"status\": \"ACTIVE\",\n  \"type\": \"GIRO\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.maesn.dev/accounting/bankAccounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<x-api-key>'
request["X-ACCOUNT-KEY"] = '<x-account-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"balance\": 100,\n  \"bankName\": \"F. van Lanschot Bankiers\",\n  \"bic\": \"SNSBNL2A\",\n  \"currency\": \"EUR\",\n  \"description\": \"Business Savings Account\",\n  \"fileType\": \"CSV\",\n  \"iban\": \"NL46INGB3591831883\",\n  \"name\": \"Business Bank\",\n  \"number\": \"0150\",\n  \"system\": \"Internal\",\n  \"status\": \"ACTIVE\",\n  \"type\": \"GIRO\"\n}"

response = http.request(request)
puts response.read_body

{
  "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

Lexware Office

Supported request parameters:

number

required

string

required

string

Required if type equals GIRO.

enum

Available options (3-letter ISO 4217):
EUR

string

required

Required if type equals GIRO.

string

required

string

required

string

required

Available options: GIRO, PAYMENT_PROVIDER

sevdesk

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:

string

Available options: CSV, MT940,

string

required

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

Get started

Guides

Integrations

Use cases

API reference

Knowledgebase

Create bank account

Field support per integration

Headers

Query Parameters

Body

Response

​Field support per integration

Headers

Query Parameters

Body

Response

Field support per integration