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

Вкратце

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

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

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

Ключ доступа выдаётся после пилота — напишите на hello@atomno.ru. Ниже примеры с 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, status (live / stub).

Профиль компании (главный 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": ["fns", "fssp", "sanctions", "egrul", "msp", "banks"]
  }'

Параметры body

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

{
  "inn": "7707083893",
  "partial": false,
  "score": 50,
  "grade": "C",
  "checks": {
    "fns": { "status": "ok" },
    "sanctions": { "status": "ok", "matched": false }
  }
}

Если одна из проверок недоступна — partial: true, остальные поля всё равно возвращаются.

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

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

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

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

Ошибки

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

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