Create or update a bank account balance

Creates a balance for the specified bank account. If a balance already exists for the same date and balance type, it will be updated with the new amount (upsert behavior).

POST /bank_account_balances

Create or update a bank account balance

cURL

curl --request POST \
  --url https://api.endclose.com/v1/bank_account_balances \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "bank_account_id": "<string>",
  "date": "2023-12-25",
  "amount_cents": 123
}
'

201

{
  "bank_account_id": 123,
  "date": "2023-12-25",
  "amount_cents": 123,
  "id": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

X-API-KEY · string · header · required

Body

application/json

bank_account_id · string · required

ID of the bank account

date · string<date> · required

The date of the balance

balance_type · enum<string> · required

The type of balance

Available options: opening_ledger, closing_ledger, current_ledger, opening_available, opening_available_next_business_day, closing_available, current_available, previously_closed_book, other

amount_cents · integer · required

The balance amount in cents (e.g., 1234 = $12.34)

Response

201

application/json

Balance created or updated

bank_account_id · integer · required

ID of the bank account this balance belongs to

date · string<date> · required

The date of the balance

balance_type · enum<string> · required

The type of balance

Available options: opening_ledger, closing_ledger, current_ledger, opening_available, opening_available_next_business_day, closing_available, current_available, previously_closed_book, other

amount_cents · integer · required

The balance amount in cents (e.g., 1234 = $12.34)

id · integer

Unique numeric identifier

created_at · string<date-time>

updated_at · string<date-time>