Получение списка счетов

Возвращает список расчетных счетов клиента: реквизиты, текущий остаток, статус и расширенную информацию по каждому счету.

Endpoint покрывает сценарии: получение списка счетов, основных реквизитов (IBAN, БИК, валюта), текущего остатка, статуса счета и детальной информации по счету.

Выписка по нескольким счетам

Получение выписки с синхронизацией по нескольким счетам выполняется через GET /api/v1/account/filter с параметром accountIds — см. Получение сборной выписки.

Endpoint	GET /api/v1/account/get-accounts-for-web
Content-Type	application/json
Response status	200 OK

Параметры запроса

Параметр	Тип	Описание
status	string	Фильтр по статусу счета
types	array of string	Фильтр по типам счетов (например, Current, Brokerage, Loro, KSNDS, SSPO, CUSTODIAN)
sort	string	Поле сортировки (например, display_order)
order	string	Направление сортировки: ASC / DESC

примечание

Параметр type используется только для фильтрации счетов — структура ответа не меняется независимо от выбранных значений фильтра.

Ответ

Поле	Тип	Описание
rows	array of objects	Список счетов (AccountView)
total.count	int	Количество записей в rows
showAll	boolean	Признак полного просмотра счетов

Описание объекта AccountView приведено в разделе Выписки → Описание объекта.

Примечание

В зависимости от подтипа запрашиваемого документа некоторые атрибуты могут возвращать пустые значения (null).

Пример запроса

Показать запрос

cURL

curl --location \
  'https://api-test.business-t.berekebank.kz/account-service/api/v1/account/get-accounts-for-web?sort=display_order&order=ASC&type=Current%2CBrokerage%2CLoro%2CKSNDS%2CSSPO%2CCUSTODIAN' \
  --header 'Authorization: Bearer <token>'

Пример ответа

Показать ответ

200 OK (сокращенный)

{
  "rows": [
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 1111,
      "number": "KZ00000KZT0000000000",
      "currency": "KZT",
      "currencyName": "Тенге",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Общий счет",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 11111111.11,
      "plannedBalance": -11111111111111.11,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "08.04.2011",
      "closedDate": null,
      "lastMoveDate": "24.02.2023",
      "actions": [
        "details",
        "payrollFromAccount",
        "statement",
        "ownAccountTransfer",
        "paymentFromAccount",
        "transfer",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": -1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    }
  ],
  "total": {
    "count": 7
  },
  "showAll": false
}

Полный пример ответа (7 счетов)

{
  "rows": [
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 1111,
      "number": "KZ00000KZT0000000000",
      "currency": "KZT",
      "currencyName": "Тенге",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Общий счет",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 11111111.11,
      "plannedBalance": -11111111111111.11,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "08.04.2011",
      "closedDate": null,
      "lastMoveDate": "24.02.2023",
      "actions": [
        "details",
        "payrollFromAccount",
        "statement",
        "ownAccountTransfer",
        "paymentFromAccount",
        "transfer",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": -1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    },
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 11111,
      "number": "KZ00000KZT0000000007",
      "currency": "KZT",
      "currencyName": "Тенге",
      "type": "KSNDS",
      "typeTranslation": "КС НДС",
      "alias": "Текущий счет АО «Демо Трейд»",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 0,
      "plannedBalance": 0,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "09.04.2021",
      "closedDate": null,
      "lastMoveDate": null,
      "actions": [
        "details",
        "payrollFromAccount",
        "statement",
        "ownAccountTransfer",
        "paymentFromAccount",
        "transfer",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": 0,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    },
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 111,
      "number": "KZ00000RUB0000000000",
      "currency": "RUB",
      "currencyName": "Российский рубль",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Текущий счет АО «Демо Трейд»",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 0,
      "plannedBalance": 111111.1,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "08.04.2011",
      "closedDate": null,
      "lastMoveDate": "24.02.2111",
      "actions": [
        "details",
        "statement",
        "transfer",
        "intTransferOrder",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": 1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    },
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 979,
      "number": "KZ00000KZT0000000008",
      "currency": "USD",
      "currencyName": "Доллар США",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Текущий счет АО «Демо Трейд»",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 0,
      "plannedBalance": -1111111.01,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "08.04.2011",
      "closedDate": null,
      "lastMoveDate": "17.03.2022",
      "actions": [
        "details",
        "statement",
        "transfer",
        "intTransferOrder",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": 1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    },
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 11111,
      "number": "KZ00000USD0000000000",
      "currency": "USD",
      "currencyName": "Доллар США",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Текущий счет АО «Демо Трейд»",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 0,
      "plannedBalance": 111,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "22.04.2021",
      "closedDate": null,
      "lastMoveDate": null,
      "actions": [
        "details",
        "statement",
        "transfer",
        "intTransferOrder",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": 1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    },
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 11111,
      "number": "KZ00000GBP0000000000",
      "currency": "GBP",
      "currencyName": "Фунт стерлингов",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Текущий счет АО «Демо Трейд»",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 0,
      "plannedBalance": 0,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "23.08.2021",
      "closedDate": null,
      "lastMoveDate": null,
      "actions": [
        "details",
        "statement",
        "transfer",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": 1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    },
    {
      "status": {
        "id": null,
        "code": "1",
        "label": "Открыт",
        "subCode": "1",
        "subLabel": "Открыт"
      },
      "id": 111,
      "number": "KZ00000KZT0000000009",
      "currency": "EUR",
      "currencyName": "Евро",
      "type": "Current",
      "typeTranslation": "Текущий",
      "alias": "Текущий счет АО «Демо Трейд»",
      "defaultAlias": null,
      "visible": true,
      "bankBranchCityId": null,
      "bankBranch": "Филиал АО «Bereke Bank» (ДБ Lesha Bank LLC (Public)) в г.Шымкент",
      "bankBranchShortName": null,
      "blockReason": null,
      "balance": 1111,
      "plannedBalance": -11111.11,
      "arrestedAmount": null,
      "blockedAmount": null,
      "organization": null,
      "organizationName": null,
      "organizationTaxCode": null,
      "openedDate": "08.04.2011",
      "closedDate": null,
      "lastMoveDate": "14.03.2022",
      "actions": [
        "details",
        "statement",
        "transfer",
        "intTransferOrder",
        "sendRequisites",
        "history"
      ],
      "demandActions": [],
      "displayOrder": 1,
      "minimalBalance": null,
      "manager": "manager01",
      "externalId": null,
      "balanceAccount": null,
      "customerId": null,
      "customerExternalId": null
    }
  ],
  "total": {
    "count": 7
  },
  "showAll": false
}