API проверки контрагентов

Вкратце

API проверки контрагентов — один HTTP-запрос по ИНН возвращает сводный профиль риска компании: карточка ЕГРЮЛ, санкционные перечни, суды общей юрисдикции, реестры ФНС. Опционально — оценка 0–100 и буква A–F.

Часть источников (приставы, банкротства, арбитраж, РНП) — в подключении: проверка объявлена в каталоге, но данные пока не приходят. Такая проверка возвращает unavailable, а не «нарушений нет», и не тарифицируется. Актуальный статус каждой проверки — на странице Проверка контрагентов.

Базовый URL (prod):

https://api.atomno-mcp.ru/compliance/

Ключ доступа выдаётся после пилота — напишите на sales@atomno.com. Ниже примеры с placeholder YOUR_API_KEY.

Быстрая проверка «жив ли сервис»

curl -s https://api.atomno-mcp.ru/compliance/health

Ожидается JSON со статусом OK.

Каталог доступных проверок

Публичный список проверок и их идентификаторов:

curl -s https://api.atomno-mcp.ru/compliance/v1/checks

В ответе — массив проверок с полями id, title_ru, availability, billing_unit.

Профиль компании (главный endpoint)

curl -s -X POST https://api.atomno-mcp.ru/compliance/v1/profile \
  -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

Пример фрагмента ответа

{
  "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 — в запросе не хватило данных. Тарифицируются только clear и hit — см. поле billable у каждой проверки.

Track2 проверки (дополнительно)

В массив checks можно передать идентификаторы из track2 (на prod с 2026-07-26):

Отличие от DaData / Kontur

Подробнее: Решение «Проверка контрагентов» →

Ошибки

Следующие шаги

1. Запросите пробный ключ: sales@atomno.com
2. Прочитайте REST vs MCP → — когда нужен MCP вместо REST
3. Лендинг для отдела продаж: /solutions/compliance