Получить банковский реквизит

GET /v1/bank-details/:id

Возвращает банковский реквизит по ID со всеми полями записи.

Параметры

Параметр Тип Обяз. Описание
id (path) number да ID банковского реквизита

Примеры

curl — личный ключ

Terminal 
curl "https://vibecode.bitrix24.tech/v1/bank-details/19" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal 
curl "https://vibecode.bitrix24.tech/v1/bank-details/19" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bank-details/19', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Счёт:', data.name, '— БИК', data.rqBik)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bank-details/19', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Объект банковского реквизита
data.id number Идентификатор банковского реквизита
data.entityId number ID реквизита-владельца. Источник: GET /v1/requisites
data.countryId number ID страны. 0 — страна не указана
data.name string Название банковского реквизита
data.active boolean Активна ли запись
data.sort number Порядок сортировки
data.code string | null Символьный код для внешних интеграций
data.xmlId string | null Внешний идентификатор для синхронизации
data.originatorId string | null ID системы-источника
data.comments string | null Комментарий к записи
data.createdAt datetime Дата создания (ISO 8601)
data.updatedAt datetime | null Дата последнего изменения (ISO 8601)
data.createdBy number ID создателя
data.modifyBy number | null ID последнего редактора
data.rqBankName string | null Наименование банка
data.rqBankAddr string | null Адрес банка
data.rqBankRouteNum string | null Маршрутный номер банка
data.rqBankCode string | null Код банка
data.rqBik string | null БИК
data.rqAccNum string | null Расчётный счёт
data.rqCorAccNum string | null Корреспондентский счёт
data.rqSwift string | null SWIFT-код
data.rqIban string | null IBAN
data.rqIik string | null ИИК (Казахстан)
data.rqMfo string | null МФО (Украина)
data.rqAccName string | null Наименование счёта
data.rqAccCurrency string | null Валюта счёта
data.rqAccType string | null Тип счёта
data.rqAgencyName string | null Наименование агентства
data.rqBic string | null BIC (международный, отдельно от rqBik)
data.rqCodeb string | null Код банка (Франция, RQ_CODEB)
data.rqCodeg string | null Код гуйше (Франция, RQ_CODEG)
data.rqRib string | null RIB (Франция)

Полный список полей с типами и признаком readonly — Поля банковского реквизита.

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

JSON 
{
  "success": true,
  "data": {
    "id": 19,
    "entityId": 1,
    "countryId": 0,
    "createdAt": "2026-06-10T10:14:29.000Z",
    "updatedAt": null,
    "createdBy": 1,
    "modifyBy": null,
    "name": "Расчётный счёт",
    "code": null,
    "xmlId": null,
    "originatorId": null,
    "active": true,
    "sort": 500,
    "rqBankName": null,
    "rqBankCode": null,
    "rqBankAddr": null,
    "rqBankRouteNum": null,
    "rqBik": "044525225",
    "rqMfo": null,
    "rqAccName": null,
    "rqAccNum": "40702810500000000001",
    "rqAccType": null,
    "rqIik": null,
    "rqAccCurrency": null,
    "rqCorAccNum": null,
    "rqIban": null,
    "rqSwift": "SABRRUMM",
    "rqBic": null,
    "rqCodeb": null,
    "rqCodeg": null,
    "rqRib": null,
    "rqAgencyName": null,
    "comments": null
  }
}

Пример ответа при ошибке

404 — банковский реквизит не найден:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "The RequisiteBankDetail with ID '999999' is not found"
  }
}

Ошибки

HTTP Код Описание
404 ENTITY_NOT_FOUND Банковский реквизит с таким ID не найден
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

Известные особенности

entityTypeId в ответе отсутствует. Поле entityTypeId передаётся при создании банковского реквизита (всегда 8 — реквизит), но в ответах get и list не возвращается. Это поле-владелец, только для записи.

countryId равен 0 у записей без страны. Если при создании страна не указана, поле возвращает числовое значение 0, а не null.

Смотрите также