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

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

`GET /api/v1/finance/transactions`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/finance/transactions`
- 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

Возвращает банковские операции, доступные вызывающему.

## Query parameters

- `business` string, uuid
- `account` string, uuid
- `match_state` string
- `direction` 'in' | 'out'
- `allocation` 'unallocated'
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Отфильтрованные операции

- FinanceTransactionPage
  - `count` integer, required: Строк на этой странице
  - `total` integer, required: Сколько операций отвечает отбору целиком; сравнение с count говорит, есть ли ещё страницы
  - `results` FinanceTransaction[], required
    - `id` string, uuid, required
    - `date` string, date, required
    - `direction` 'in' | 'out', required
    - `amount` string, required: Positive decimal string
    - `currency` string, required
    - `counterparty_name` string, required
    - `counterparty_inn` string, required
    - `counterparty_account` string, required
    - `purpose` string, required
    - `bank_txn_id` string, required
    - `account` string, uuid, required
    - `account_name` string, required
    - `statement` string, uuid, nullable, required
    - `cashflow_item` string, uuid, nullable, required
    - `cashflow_item_name` string, nullable, required
    - `cashflow_section` string, nullable, required
    - `pnl_item` string, uuid, nullable, required
    - `pnl_item_name` string, nullable, required
    - `contact` string, uuid, nullable, required
    - `contact_name` string, nullable, required
    - `for_contact` string, uuid, nullable: «За кого»: контрагент из папки «Сотрудники» или «Собственники», чей расчёт гасит платёж. Пусто — как контрагент: платили самому человеку
    - `for_contact_name` string, nullable
    - `contact_employee` string, uuid, nullable: Сотрудник, связанный с контрагентом. У зарплаты пустое «За кого» при нём означает самого получателя
    - `order` string, uuid, nullable, required
    - `order_number` string, nullable, required
    - `project` string, uuid, nullable, required
    - `project_name` string, nullable, required
    - `responsible` string, uuid, nullable: Инициатор: кто завёл или согласовал платёж. В проводки не идёт; чей расчёт гасится, задаёт for_contact
    - `responsible_name` string, nullable
    - `order_total` string, nullable, required
    - `order_paid_percent` integer, required
    - `match_state` string, required
    - `reconciliation_state` string, required
    - `reconciliation_needs` string[], required
    - `classification_explanation` string, required
    - `suggested_order` object, nullable, required
    - `suggested_cashflow_item` object, nullable, required
    - `suggested_pnl_item` object, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `totals` FinanceTransactionTotals, required: Итоги по всему отбору, а не по странице. Суммы в валюте учёта по историческому курсу
    - `inflow` string, nullable, required: Приход; null, когда итог не посчитан
    - `outflow` string, nullable, required: Расход; null, когда итог не посчитан
    - `currency` string, required
    - `unconverted_count` integer, required: Сколько операций осталось без пересчёта в валюту учёта: неполный пересчёт не должен выглядеть верным итогом
  - `limit` integer: Размер страницы, применённый сервером
  - `offset` integer: Смещение этой страницы
  - `has_more` boolean: Есть ли строки за этой страницей: true — запросите следующую с offset + count

## 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)