Счета

Получение счетов

Возвращает список счетов организации с текущими балансами. Требует доступ org.accounts.read и scope legal в токене.

Запрос

Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/organisation/{organisationId}/accounts

Path Parameters

Параметр	Тип	Обязательное поле	Пример	Описание
organisationId	string (uuid)	Да	550e8400-e29b-41d4-a716-446655440000	ID организации

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

curl -X 'GET' \
  "https://b2b.selfwork.ru/openapi/v2/organisation/550e8400-e29b-41d4-a716-446655440000/accounts" \
  -H "accept: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "result": [
    {
      "id": "019d0abb-b34b-7fcc-94a7-873f55b527f8",
      "name": "Рублевый счет",
      "type": "INTERNAL",
      "currency": "RUB",
      "mainFlag": "Y",
      "balance": {
        "balance": 21123,
        "reserved": 5000,
        "updated": "2024-05-22T21:11:28.970Z"
      }
    }
  ],
  "success": true
}

Описание полей ответа

Поле	Тип	Описание
requestId	string	Уникальный идентификатор запроса
success	boolean	Статус выполнения запроса (true/false)
result	array	Массив счетов организации
id	string	Идентификатор счёта (строка)
name	string	Название счёта
type	string	Тип счёта: INTERNAL, EXTERNAL
currency	string	Код валюты счёта (например, RUB)
mainFlag	string	Флаг основного счёта (Y / N)
balance	object	Баланс счёта (см. ниже)

Поля баланса счёта (balance)

Поле	Тип	Описание
balance	number	Доступный остаток в копейках: можно направить на выплаты
reserved	number	Сумма, зарезервированная под операции в обработке, в копейках
updated	string	Дата и время последнего изменения остатков (ISO 8601)

Возможные ошибки

Code	Описание
VALIDATION_ERROR	Ошибка валидации
FORBIDDEN_ERROR	Ошибка авторизации
UNKNOWN_ERROR	Ошибка сервера