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

API и MCP

Реквизиты по ИНН, сведения ФНС, МСП и сверка по публичным перечням.

Состав проверки отражается в каждом ответе. Недоступные источники отмечаются отдельно.

Задача

Заполнение карточки клиента и проверка перед договором.

Быстрый старт

Проверьте доступ
Получите пробный доступ или подключите пакет в кабинете.
Подготовьте ключ
Используйте ключ с доступом к этому продукту из раздела API-ключи.
Выполните запрос с вашего сервера
Замените YOUR_API_KEY своим ключом. Начните с одного запроса, затем проверьте поля ответа.

curl · пример запроса

curl -X POST \
  https://api.atomno-mcp.ru/mcp-fns-check/v1/check-contractor \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inn":"7707083893"}'

Доступ и авторизация

Заголовок ключа

X-API-Key: YOUR_API_KEY

Допустим также заголовок Authorization: Bearer YOUR_API_KEY. Передавайте один способ авторизации в запросе.

Храните ключ на сервере вашего приложения. Не публикуйте его в клиентском коде и не передавайте в URL.

Запрос и параметры

POSThttps://api.atomno-mcp.ru/mcp-fns-check/v1/check-contractor

JSON · тело запроса

{
  "inn": "7707083893"
}

Параметр	Назначение
`inn`	ИНН компании
`identifier`	ИНН или ОГРН вместо inn

Ответ и поля

JSON · учебный пример

{
  "identifier": "7707083893",
  "inn": "7707083893",
  "card": {
    "inn": "7707083893",
    "name": {
      "full": "Учебная компания"
    }
  },
  "package_checks": [],
  "verdict_action": "manual_review_required",
  "verdict_reason_ru": "Проверки не выполнены"
}

Учебный фрагмент структуры ответа. Это не результат проверки компании или поиска документов.

Поле	Что содержит
`inn / ogrn`	Идентификаторы компании
`card`	Реквизиты
`package_checks`	Результаты отдельных проверок
`package_checks[].state`	answered — ответ получен; not_checked — не проверено
`package_checks[].source_ru / page_url`	Источник и ссылка
`package_checks[].data_as_of`	Дата сведений источника
`checked_at`	Время проверки

Ошибки

HTTP	Причина и действие
`401`	Ключ отсутствует или не принят Проверьте заголовок и действующий ключ.
`403`	Нет доступа к продукту Проверьте подключённый пакет и срок подписки.
`400 / 422`	Ошибка параметров Исправьте формат и обязательные поля запроса.
`429`	Превышен лимит Уменьшите частоту и проверьте остаток квоты.
`502 / 503`	Источник или сервис недоступен Не трактуйте отказ как отсутствие данных; сохраните код и текст ошибки.

При повторяющейся ошибке сообщите поддержке метод, время запроса и код ответа. Ключ отправлять не нужно.

Условия использования

Не считайте «не проверено» положительным результатом проверки.

Дата проверки и дата сведений источника могут различаться.

Происхождение данных

ФНС и публичные перечни. Дату сведений и ссылки на документы учитывайте вместе с результатом.

Все инструменты Тарифы и доступ