Neues Bankkonto anlegen

Legt ein neues Bankkonto an und verknüpft es 1:1 mit einem bestehenden SKR04-Aktivkonto. Dasselbe Konto kann nicht mehreren Bankkonten zugeordnet werden.

POST /v1/bank-accounts

Authorization

Authorization string header erforderlich API-Key im Format ll_.... Übergabe als Bearer Token.

Request Body

name string erforderlich Kontobezeichnung (max 255)

iban string erforderlich IBAN (15–34 Zeichen)

bic string optional BIC (max 11)

account_number string erforderlich SKR04-Kontonummer (1–8 Stellen, muss als Aktivkonto im Kontenplan existieren und darf noch keinem anderen Bankkonto zugeordnet sein)

currency string optional Währung (3 Zeichen, Default: EUR)

Antworten

201

Erfolgreich

400

INVALID_INPUT Pflichtfelder fehlen oder Werte entsprechen nicht dem erwarteten Format.

400

ACCOUNT_NOT_FOUND Das angegebene Aufwands- oder Ertragskonto existiert nicht im Kontenplan.

400

INVALID_ACCOUNT_TYPE

409

ACCOUNT_ALREADY_LINKED

409

DUPLICATE_IBAN

POST /v1/bank-accounts

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/bank-accounts' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "name": "Geschäftskonto",
  "iban": "DE89370400440532013000",
  "account_number": "1800"
}'

201 Response

JSON

angelegtes Bankkonto.