API проверки контрагентов
Состав и ограничения API проверки контрагентов: подтверждённые сведения, описание методов и различие статусов источников.
Обновлено:
Вкратце
API проверки контрагентов — интерфейс сводного запроса по ИНН.
Подтверждённый ограниченный состав — карточка организации, локальные копии ФНС,
сведения МСП и четыре официальных перечня. Судебная практика в этом запросе не подтверждена.
Ниже сохранено описание полей, в том числе необязательных score и grade;
наличие поля в описании не подтверждает его работу в текущем подключении.
Часть источников (приставы, банкротства, арбитраж, РНП) — в подключении: проверка объявлена в каталоге, но данные пока не приходят. Такая проверка возвращает
unavailable, а не «нарушений нет». Фактический состав — на странице проверки контрагента, условия учёта запросов — в тарифе и кабинете.
Общий адрес REST API — api.atomno-data.ru. Полный URL конкретного метода берите из инструкции подключения. Ниже сохранено описание интерфейса /compliance; оно само по себе не подтверждает доступность каждого метода. Подтверждённый состав — на странице сервера.
Ключ и подключённые пакеты — в общем кабинете, условия — на странице тарифов. В примерах YOUR_API_KEY — ваш ключ, а ATOMNO_HEALTH_URL, ATOMNO_CHECKS_URL и ATOMNO_METHOD_URL — полные URL соответствующих методов из инструкции подключения.
Быстрая проверка «жив ли сервис»
curl -s "$ATOMNO_HEALTH_URL"
Health-метод проверяет доступность сервиса. Даже ответ 200 со статусом OK не доказывает, что конкретный реестр вернул актуальные данные. Ответы 401 и 403 требуют проверки ключа и прав и сами по себе не означают недоступность источника.
Каталог доступных проверок
Публичный список проверок и их идентификаторов:
curl -s "$ATOMNO_CHECKS_URL"
В ответе — массив проверок с полями id, title_ru, availability, billing_unit.
Профиль компании (главный endpoint)
curl -s -X POST "$ATOMNO_METHOD_URL" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inn": "7707083893",
"include_score": true,
"checks": ["egrul", "rfm_screen", "foreign_agent", "soyu", "msp", "cbr_bank"]
}'
Параметры body
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
inn | string | да | ИНН юрлица (10 или 12 цифр) |
include_score | boolean | нет | Добавить score (0–100) и grade (A–F) |
checks | string[] | нет | Подмножество проверок; по умолчанию — все live |
Пример фрагмента ответа
Учебный пример структуры, не текущий ответ сервера и не подтверждение количества списанных единиц.
{
"score": 50,
"grade": "C",
"billing_units": 2,
"checks": [
{ "id": "egrul", "status": "clear", "source": "mcp-fns-check", "billable": true },
{ "id": "rfm_screen", "status": "clear", "source": "mcp-sanctions", "billable": true },
{ "id": "arbitration", "status": "unavailable", "billable": false }
]
}
Значения status: clear — реестр ответил, нарушений нет; hit — реестр ответил, нарушение
есть; unavailable / error — реестр не ответил (это не равно «нарушений нет»); stub —
ответ получен на демонстрационном наборе; skipped — в запросе не хватило данных.
Поля billable и billing_units показаны как часть описания интерфейса.
Действующий порядок учёта запросов проверяйте в тарифе и кабинете.
Track2 проверки (дополнительно)
В сохранённом описании интерфейса перечислены следующие идентификаторы. Это не текущая автоматическая проверка каждого метода:
| id | Смысл | Статус |
|---|---|---|
msp | Реестр МСП ФНС | сведения МСП входят в подтверждённый состав; отдельный метод проверяйте по инструкции |
disqualified | Дисквалифицированные директора | описан в интерфейсе; отдельная текущая проверка здесь не приведена |
cbr_bank | Справочник банков ЦБ (БИК) | описан в интерфейсе; отдельная текущая проверка здесь не приведена |
rnp | Реестр недобросовестных поставщиков | в подключении |
mass_address | Массовый адрес регистрации | демонстрационный набор, не проверка живого источника |
Отличие от DaData / Kontur
| DaData / Checko | API проверки контрагентов | |
|---|---|---|
| Модель | Поле в форме / отдельные API | Один POST — профиль |
| AI-агент | Ограниченный MCP (4 tools у DaData) | MCP + REST, checks[] composable |
| Score | Kontur.Focus UI | API field include_score |
| Самостоятельный доступ для разработчиков | Ключ + docs | Открытые MCP-клиенты + hosted API |
Подробнее: Решение «Проверка контрагентов» →
Ошибки
| HTTP | Смысл |
|---|---|
| 401 | Неверный или отсутствующий ключ |
| 422 | Невалидный ИНН |
| 429 | Превышен лимит запросов |
| 503 | Частичная недоступность upstream — смотрите partial |
Следующие шаги
- Посмотрите подтверждённый состав и условия доступа.
- Прочитайте REST vs MCP → — когда нужен MCP вместо REST
- Лендинг для отдела продаж: /solutions/compliance/
Частые вопросы
Описание метода подтверждает доступность всех проверок?
Нет. На странице сохранено описание интерфейса /compliance, а состав источников и полный URL метода нужно сверять с условиями подключения. Наличие проверки в схеме не означает, что она возвращает данные по вашему ключу.
Чем unavailable отличается от clear и stub?
В описанной схеме clear означает полученный ответ без найденного нарушения, unavailable — отсутствие ответа источника, а stub — демонстрационный набор. Ни unavailable, ни stub нельзя трактовать как успешную проверку живого реестра без рисков.
Что показывает сводная проверка контрагента?
Она объединяет результаты доступных проверок, сохраняя статус каждого источника. Состав вашего подключения нужно сверять отдельно: наличие поля в описании API не гарантирует получение данных по нему.
Можно ли передать итог проверки сотруднику для решения?
Да, вместе с исходными статусами, источниками и датами. Не заменяйте неполученные сведения выводом «рисков нет»; сводка помогает разбору, но не принимает решение за вашу организацию.
Можно ли показать сотруднику только общий балл риска?
Не скрывайте состав проверки за одним итогом. Сохраните источник, дату и статус каждого пункта, чтобы было видно, какие сведения получены, а какие недоступны или демонстрационные.
Можно ли запросить только часть проверок компании?
В описании body есть необязательный массив checks для выбора подмножества проверок. Наличие идентификатора проверки в запросе не подтверждает доступность её источника; сверяйте действующий состав продукта.
Можно ли считать работоспособность сервиса проверкой конкретной компании?
Нет. Успешный ответ самого сервиса не описывает контрагента. Для решения нужен запрос по нужному идентификатору, фактические сведения и статусы источников, участвовавших в этой проверке.
