Bank Accounts

Create a bank account

post/bank-accounts

Request

Base URL: https://api.lumabill.ch/v1
URL: https://api.lumabill.ch/v1/bank-accounts
Auth: HTTP bearer

Request body

namestring required

ibanstring nullable

bankNamestring nullable

currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF' required

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

chartAccountIdstring uuid nullable

Linked chart-of-accounts posting account used when booking this bank account's transactions.

type'BANK' | 'CASH'

isActiveboolean

confirmPostingAccountChangeboolean

PUT only. Must be true to change chartAccountId when the bank account already has booked transactions; otherwise the request is rejected with 409 POSTING_ACCOUNT_HAS_BOOKINGS. Existing bookings stay on the old account; only new bookings use the new one.

Example request

{
  "name": "PostFinance CHF",
  "iban": "CH56 0483 5012 3456 7800 9",
  "currency": "CHF"
}

Response

Bank account created

idstring uuid required

namestring required

ibanstring nullable

bicstring nullable

currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF' required

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

chartAccountIdstring uuid nullable

Posting account of this bank account

chartAccountCurrency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF'

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

bank_namestring nullable

account_numberstring nullable

Chart-of-accounts account number linked to this bank account

created_atstring date-time required

Example response

{
  "id": "b8c9d0e1-8901-cdef-1234-567890123456",
  "name": "PostFinance CHF",
  "iban": "CH56 0483 5012 3456 7800 9",
  "bic": "POFICHBEXXX",
  "currency": "CHF",
  "chartAccountCurrency": "CHF",
  "bank_name": "PostFinance AG",
  "account_number": "1020",
  "created_at": "2025-01-01T00:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.