---
title: "Получить доступные банковские счета"
method: GET
path: "/api/v1/finance/accounts"
tags: ["Finance accounts"]
---

# Получить доступные банковские счета

`GET /api/v1/finance/accounts`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/accounts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Возвращает только счета и кассы бизнесов и юрлиц области права сотрудника (AUTHZ.md § 2.2); поиск идёт по реквизитам и названию.

## Query parameters

- `business` string, uuid
- `q` string

## Headers

- `X-Tenant` string, required

## Response `200`

Доступные счета с текущим остатком и состоянием синхронизации

- FinanceAccountPage
  - `count` integer, required
  - `results` FinanceAccount[], required
    - `id` string, uuid, required
    - `business` string, uuid, nullable: Бизнес, которому принадлежат деньги — у счёта из юрлица, у кассы из её карточки. null только у старого счёта без юрлица в кабинете с несколькими бизнесами.
    - `kind` 'bank' | 'cash', required: Где лежат деньги. `bank` — расчётный счёт, `cash` — касса из справочника «Кассы». Список общий намеренно: вопрос «сколько у меня денег» задаётся один раз. У кассы банковские поля (`bic`, `number`, `bank_name`, `connector`) пусты по построению, а не «ещё не заполнены», и карточка счёта по её идентификатору не открывается.
    - `company` string, uuid, nullable, required
    - `bank` string, uuid, nullable, required
    - `company_name` string, required
    - `company_directory_name` string, required
    - `company_inn` string, required
    - `company_is_active` boolean, required
    - `name` string, required
    - `bank_name` string, required
    - `bic` string, required
    - `number` string, required
    - `currency` string, required
    - `gl_account` string, uuid, nullable, required
    - `is_active` boolean, required
    - `opening_balance` string, required: Decimal string
    - `balance` string, required: Decimal string
    - `txn_count` integer, required
    - `connector` string, uuid, nullable, required
    - `connector_name` string, required
    - `connector_status` string, required
    - `sync_enabled` boolean, required
    - `synced_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `bank_balance` string, nullable: Остаток по данным банка на момент `bank_balance_at`, decimal string. null — банк остатка не называл (счёт не подключён или остаток ещё не приходил): это не ноль, и сверять с ним нечего.
    - `bank_balance_at` string, date-time, nullable: Когда банк назвал остаток `bank_balance`.
    - `bank_closed_at` string, date-time, nullable: Когда счёт закрыт банком. null — счёт действующий.
    - `in_use_since` string, date: «Используется с»: с какой даты счёт принадлежит бизнесу. Операции раньше неё коннектор не запрашивает, загрузка файла пропускает, ручной ввод отклоняет. Поля нет — ограничения нет.
    - `bank_timezone` string, nullable: Часовой пояс банковских суток счёта (IANA), например Asia/Novosibirsk. По нему банк режет сутки выписки, и по нему считаются окно синхронизации, «Загрузить период» и остаток на дату. Умолчание — по БИК подразделения банка. null у кассы.
    - `bank_timezone_source` 'bic' | 'default' | 'manual' | 'null', nullable: Откуда пояс: `bic` — определён по БИК, `default` — определить не удалось, стоит умолчание (проверьте пояс), `manual` — задан человеком; подключение банка ручной пояс не трогает.
    - `account_type` 'settlement' | 'deposit': Вид счёта. `settlement` — расчётный (счёт книги 51), `deposit` — вклад. Деньги вклада учитываются статьёй «Депозиты и вклады»: отправка и возврат идут ею, а остаток депозитного счёта в итог денег не входит.
    - `account_type_source` 'number' | 'bank' | 'manual': Откуда вид: `number` — выведен из номера счёта (421…–422… и 423…, 426… — вклад), `bank` — назван банком, `manual` — выбран человеком. Ручной выбор номер и банк не перебивают.

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `500`: Внутренняя ошибка без раскрытия server-only деталей

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)