---
title: "Bulk create or update bank account balances"
method: POST
path: "/bank_account_balances/bulk"
---

# Bulk create or update bank account balances

`POST /bank_account_balances/bulk`

Submit up to 1,000 balances for a bank account in a single request. Each balance is upserted — if a balance already exists for the same date and balance type, it will be updated with the new amount. All balances are processed in a single transaction.

## Request body

- object
  - `bank_account_id` string, required — ID of the bank account
  - `balances` object[], required
    - `date` string, date, required — The date of the balance
    - `balance_type` 'opening_ledger' | 'closing_ledger' | 'current_ledger' | 'opening_available' | 'opening_available_next_business_day' | 'closing_available' | 'current_available' | 'previously_closed_book' | 'other', required — The type of balance
    - `amount_cents` integer, required — The balance amount in cents (e.g., 1234 = $12.34)

## Response `201`

Balances created or updated

- object
  - `count` integer — Number of balances processed
  - `balances` BankAccountBalance[]
    - `id` integer — Unique numeric identifier
    - `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` 'opening_ledger' | 'closing_ledger' | 'current_ledger' | 'opening_available' | 'opening_available_next_business_day' | 'closing_available' | 'current_available' | 'previously_closed_book' | 'other', required — The type of balance
    - `amount_cents` integer, required — The balance amount in cents (e.g., 1234 = $12.34)
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `422` — Validation error (e.g. exceeds 1,000 balances)

---

[API](https://skmtc.net/endclose/apis/end-close-api.md) · [All operations](https://skmtc.net/endclose/apis/end-close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/endclose/end-close-api/revisions/613ceff68dc7/schema)