Skip to main content
PATCH
Update Bank Account

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

account_uuid
string
required

Body

application/json

The editable part of a bank account. Every field is optional: only the ones actually present in the request body are applied, so omitting a field leaves it untouched.

Any other field of the account (origin, the balances, currency, the timestamps...) is read-only and rejected if sent, rather than ignored — a typo in a field name is an error, not a silent no-op.

title
string | null

Name of the account.

Maximum string length: 500
reference
string | null

The account's IBAN, validated (ISO 13616 structure and check digits) and stored uppercase without spaces. Editable only on a manual account: on a ponto or coda account it is owned by the bank feed.

Maximum string length: 100
bic
string | null

BIC/SWIFT code. Editable only on a manual account, like reference.

Maximum string length: 11
display_on_invoice
boolean | null

Whether this account is printed on the invoices the company issues.

default
boolean | null

Makes this account the company's default. Setting it to true demotes the previous default in the same operation. A company must always keep exactly one default, so setting it to false is refused: promote another account instead.

Response

Successful Response

A bank account of the company, identified by an opaque id.

Balances are decimal numbers in the account's currency; they are null for accounts Fidly does not synchronise (a manual account carries no balance).

id
string
required

Opaque unique identifier of the bank account.

origin
string
required

How the account came into Fidly. One of: ponto (synchronised through the banking connection), coda (created from a CODA statement), manual.

title
string | null
required

Name of the account.

reference
string | null
required

Account reference, usually the IBAN.

bic
string | null
required

BIC/SWIFT code of the institution.

current_balance
number | null
required

Current balance of the account.

available_balance
number | null
required

Balance actually available for spending.

currency
string | null
required

ISO 4217 currency code of the balances (e.g. EUR).

default
boolean
required

true when this is the company's default account.

display_on_invoice
boolean
required

true when this account is printed on the invoices the company issues.

created_at
string<date-time> | null
required

When the account was added to Fidly (ISO 8601).

updated_at
string<date-time>
required

When the account was last modified (ISO 8601).