# Financing balances: Bimp API methods

URL: https://bimpsoft.com/en/help/developers/api-reference/financing-balance/

Bimp API methods for the “Financing balances” resource (`/org2/financing-balance/…`): 1 method. Base URL: `https://app.bimpsoft.com`. All requests except login pass the company token in the `access-token` header — see [Getting started with the API](/en/help/developers/api-getting-started/).

Balances by bank accounts and cash registers

| Method | What it does |
|---|---|
| [`POST /org2/financing-balance/api-readList`](#api-read-list) | A request to view balances by bank accounts and cash registers |

## api-readList

`POST /org2/financing-balance/api-readList`

A request to view balances by bank accounts and cash registers

**Request body (JSON)**

| Field | Type | Required | Description |
|---|---|---|---|
| `period` | object[] |  | Optional period range as a tuple of two ISO 8601 date-time strings in UTC |

**Response: `data` field**

| Field | Type | Description |
|---|---|---|
| `currency` | object |  |
| `currency.uuid` | string (uuid) |  |
| `currency.name` | string |  |
| `totalBalance` | number |  |
| `cashRegistersBalance` | number |  |
| `bankAccountsBalance` | number |  |
| `bankAccounts` | object[] |  |
| `bankAccounts[].account` | object |  |
| `bankAccounts[].account.uuid` | string (uuid) |  |
| `bankAccounts[].account.name` | string |  |
| `bankAccounts[].currency` | object |  |
| `bankAccounts[].currency.uuid` | string (uuid) |  |
| `bankAccounts[].currency.name` | string |  |
| `bankAccounts[].amount` | number | Amount in the organization base currency |
| `bankAccounts[].amountInCurrency` | number | Amount in the account currency |
| `cashRegisters` | object[] |  |
| `cashRegisters[].account` | object |  |
| `cashRegisters[].account.uuid` | string (uuid) |  |
| `cashRegisters[].account.name` | string |  |
| `cashRegisters[].currency` | object |  |
| `cashRegisters[].currency.uuid` | string (uuid) |  |
| `cashRegisters[].currency.name` | string |  |
| `cashRegisters[].amount` | number | Amount in the organization base currency |
| `cashRegisters[].amountInCurrency` | number | Amount in the account currency |

```bash
curl -X POST 'https://app.bimpsoft.com/org2/financing-balance/api-readList' \
  -H 'access-token: <company token>' \
  -H 'Content-Type: application/json' \
  -d '{"period":["2026-07-31T21:00:00.000Z","2026-08-30T21:00:00.000Z"]}'
```

Interactive documentation with a test request option: [https://app.bimpsoft.com/docs](https://app.bimpsoft.com/docs). The OpenAPI specification is updated together with Bimp; this page is generated from it automatically.