API Бизтории
beta
Проверка контрагентов из вашей CRM, 1С или скоринговой модели. Те же источники, что и в кабинете, ответом в JSON. Каждый блок ответа содержит источник и дату получения данных — ответ можно приложить к досье и объяснить проверяющему, откуда цифра.
Метод
Что делаетЦена запроса
Юридические лица
Физические лица и ИП
Мониторинг
GET
/v1/company/{inn}
Полная проверка юрлица
Все доступные блоки по организации одним запросом: реквизиты ЕГРЮЛ, финансы, арбитраж, ФССП, госконтракты, залоги, риски. Каждый блок содержит source и last_updated_at — источник и дату получения, чтобы ответ можно было приложить к досье.
Параметры и пример ответа →
18 ₽
за один ИНН
GET
/v1/company/{inn}/brief
Краткая справка
Только реквизиты и статус из ЕГРЮЛ — без обращения к судам и приставам. Подходит для массовой валидации списка контрагентов перед полной проверкой.
Параметры и пример ответа →
4 ₽
за один ИНН
GET
/v1/company/{inn}/score
Оценка риска
Сводный балл надёжности от 0 до 100 и перечень сработавших признаков. Отдельно возвращается признак того, что часть источников не ответила — балл в этом случае считать полным нельзя.
Параметры и пример ответа →
12 ₽
за один ИНН
GET
/v1/person/{inn}
Проверка физлица или ИП
Проверка по 12-значному ИНН: статус ИП, исполнительные производства, банкротство, арбитраж, суды общей юрисдикции. Требует основания обработки персональных данных — оно передаётся параметром consent и фиксируется в журнале 152-ФЗ.
Параметры и пример ответа →
22 ₽
за один ИНН
POST
/v1/person/lookup
Поиск ИНН по ФИО
Обратный поиск: по ФИО, дате рождения и паспорту возвращает ИНН. Источник — сервис ФНС. Возвращает пустой результат, если совпадение не однозначно.
Параметры и пример ответа →
9 ₽
за один поиск
POST
/v1/monitoring
Поставить на мониторинг
Ставит контрагента на наблюдение. При изменениях приходит вебхук на указанный адрес. Списание идёт за каждое сработавшее событие, а не за подписку.
Параметры и пример ответа →
бесплатно
бесплатно, списывается за срабатывания
DELETE
/v1/monitoring/{id}
Снять с мониторинга
Прекращает наблюдение и отправку вебхуков по подписке.
Параметры и пример ответа →
бесплатно
бесплатно
GET
/v1/company/{inn}
Полная проверка юрлица
Описание
Все доступные блоки по организации одним запросом: реквизиты ЕГРЮЛ, финансы, арбитраж, ФССП, госконтракты, залоги, риски. Каждый блок содержит source и last_updated_at — источник и дату получения, чтобы ответ можно было приложить к досье.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| inn | path | string | да | ИНН организации, 10 цифр
пример: 7707083893
|
| blocks | query | string | нет | Список блоков через запятую. По умолчанию все. Значения: company, financial, arbitration, fssp, contracts, pledges, risks
пример: company,arbitration
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"inn": "7707083893",
"fssp": {
"total_debt": 0.0,
"proceedings": []
},
"_meta": {
"source": "ЕГРЮЛ, КАД Арбитр, ФССП",
"last_updated_at": "31.08.2026 (14:05)"
},
"company": {
"region": "77",
"status": "active",
"short_name": "ПАО СБЕРБАНК",
"registration_date": "20.06.1991"
},
"arbitration": {
"cases": [
{
"role": "Ответчик",
"court": "АС города Москвы",
"amount": 1450000.0,
"result": "Удовлетворено",
"case_number": "А40-12345/2026"
}
],
"total_cases": 128
}
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| inn | string | ИНН организации |
| company.short_name | string | Сокращённое наименование |
| company.status | string | Статус: active, liquidating, liquidated, bankruptcy |
| company.registration_date | string | Дата регистрации, ДД.ММ.ГГГГ |
| arbitration.total_cases | int | Всего арбитражных дел |
| arbitration.cases[] | array | Дела: номер, суд, роль, сумма, исход |
| fssp.total_debt | number | Сумма исполнительных производств, ₽ |
| risks.flags[] | array | Сработавшие признаки риска |
| _meta.source | string | Источник по каждому блоку |
| _meta.last_updated_at | string | Дата получения данных |
Стоимость
18 ₽ за один ИНН
GET
/v1/company/{inn}/brief
Краткая справка
Описание
Только реквизиты и статус из ЕГРЮЛ — без обращения к судам и приставам. Подходит для массовой валидации списка контрагентов перед полной проверкой.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| inn | path | string | да | ИНН организации
пример: 7707083893
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"ogrn": "1027700132195",
"status": "active",
"address": "117312, г. Москва, ул. Вавилова, д. 19",
"director": "Греф Герман Оскарович",
"short_name": "ПАО СБЕРБАНК"
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| short_name | string | Сокращённое наименование |
| ogrn | string | ОГРН |
| status | string | Статус организации |
| address | string | Юридический адрес |
| director | string | Руководитель |
Стоимость
4 ₽ за один ИНН
GET
/v1/company/{inn}/score
Оценка риска
Описание
Сводный балл надёжности от 0 до 100 и перечень сработавших признаков. Отдельно возвращается признак того, что часть источников не ответила — балл в этом случае считать полным нельзя.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| inn | path | string | да | ИНН организации
пример: 7707083893
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"flags": [
{
"code": "arbitration_defendant",
"title": "Ответчик по арбитражным делам",
"weight": -8
}
],
"level": "medium",
"score": 78,
"incomplete": false
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| score | int | Балл 0-100 |
| level | string | Уровень: low, medium, high |
| flags[] | array | Сработавшие признаки с весом |
| incomplete | bool | Часть источников не ответила — балл неполный |
Стоимость
12 ₽ за один ИНН
GET
/v1/person/{inn}
Проверка физлица или ИП
Описание
Проверка по 12-значному ИНН: статус ИП, исполнительные производства, банкротство, арбитраж, суды общей юрисдикции. Требует основания обработки персональных данных — оно передаётся параметром consent и фиксируется в журнале 152-ФЗ.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| inn | path | string | да | ИНН физлица, 12 цифр
пример: 163801767100
|
| consent | query | bool | да | Подтверждение законного основания обработки ПДн. Без него запрос отклоняется с кодом 451
пример: true
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"fio": "ИВАНОВ ИВАН ИВАНОВИЧ",
"fssp": {
"total_debt": 45300.0,
"proceedings": 2
},
"is_ip": true,
"courts": {
"total_cases": 3
},
"bankruptcy": {
"active": false
}
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| fio | string | ФИО |
| is_ip | bool | Является индивидуальным предпринимателем |
| fssp.total_debt | number | Сумма производств, ₽ |
| bankruptcy.active | bool | Действующее банкротство |
| courts.total_cases | int | Дел в судах общей юрисдикции |
Стоимость
22 ₽ за один ИНН
POST
/v1/person/lookup
Поиск ИНН по ФИО
Описание
Обратный поиск: по ФИО, дате рождения и паспорту возвращает ИНН. Источник — сервис ФНС. Возвращает пустой результат, если совпадение не однозначно.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| last_name | body | string | да | Фамилия
пример: Иванов
|
| first_name | body | string | да | Имя
пример: Иван
|
| middle_name | body | string | нет | Отчество
пример: Иванович
|
| birth_date | body | string | да | Дата рождения ДД.ММ.ГГГГ
пример: 01.01.1980
|
| passport | body | string | да | Серия и номер паспорта
пример: 1234567890
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"inn": "163801767100",
"found": true
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| inn | string | Найденный ИНН или пустая строка |
| found | bool | Однозначное совпадение найдено |
Стоимость
9 ₽ за один поиск
POST
/v1/monitoring
Поставить на мониторинг
Описание
Ставит контрагента на наблюдение. При изменениях приходит вебхук на указанный адрес. Списание идёт за каждое сработавшее событие, а не за подписку.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| inn | body | string | да | ИНН контрагента
пример: 7707083893
|
| webhook_url | body | string | да | HTTPS-адрес для уведомлений
пример: https://crm.example.ru/hooks/biztoria
|
| events | body | array | нет | События: status, arbitration, fssp, bankruptcy, address. По умолчанию все
пример: ["status","bankruptcy"]
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"id": "mon_8f21c4",
"inn": "7707083893",
"events": [
"status",
"bankruptcy"
]
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| id | string | Идентификатор подписки |
| inn | string | ИНН контрагента |
| events[] | array | Отслеживаемые события |
Стоимость
Бесплатно — бесплатно, списывается за срабатывания
DELETE
/v1/monitoring/{id}
Снять с мониторинга
Описание
Прекращает наблюдение и отправку вебхуков по подписке.
Параметры запроса
| Имя | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| id | path | string | да | Идентификатор подписки
пример: mon_8f21c4
|
| X-Api-Key | header | string | да | Ключ доступа
пример: biz_live_…
|
Пример ответа
{
"ok": true
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| ok | bool | Подписка снята |
Стоимость
Бесплатно — бесплатно