Проверить организацию
GET https://www.rsnmo.ru/api/v1/company?inn=7707329152
Передавайте ИНН строкой из 10 или 12 цифр с корректными контрольными цифрами. Начальные нули сохраняются. Ключ доступа на этом этапе не требуется.
Формат ответа
api_version — версия контракта; request_id — идентификатор запроса, также в заголовке X-Request-ID; data — сведения; meta — ограничения и состояния источников. В успешном ответе error равен null.
data.found=false означает, что в загруженных данных сведений не найдено. Это не подтверждает отсутствие организации. Успешный поиск, в том числе без совпадений, возвращает HTTP 200.
Как понимать источники
| Поле / значение | Значение |
|---|---|
lookup_status: found | В ответе есть записи этого источника. |
no_local_data | Локальный поиск выполнен, пригодных для ответа записей нет. Отсутствие сведений в официальном реестре не подтверждено. |
not_checked | Проверка этого источника не выполнена. |
unavailable | Компонент не удалось прочитать; результат по нему неизвестен. |
update_status | fresh, stale, unavailable или unknown — состояние обновления источника, отдельно от наличия сохранённых данных. |
data_loaded_at | Дата загрузки самых новых из возвращённых записей, если известна. |
last_successful_import_at | Последний успешный импорт по отчёту мониторинга. Это не дата выпуска документа и не дата проверки этой организации. |
Состояние fresh означает соблюдение контрольного интервала обновления, а не актуальность каждого документа. Если отчёт мониторинга отсутствует или старше 48 часов, состояние обновления — unknown. Источники, работающие по отдельным ИНН, не считаются полными снимками реестра.
Полнота и ограничения
meta.completeness=partial: ответ построен по локальным данным. История контрактов загружена не полностью, события судов и банкротств пока не загружены. Массивы ограничены; returned_records — число возвращённых строк, не общий объём реестра. Источники в meta.sources описывают реестры и основные наборы финансовых, регистрационных и закупочных данных; производные поля могут объединять несколько источников.
Запрос может поставить отсутствующие или устаревшие сведения в существующую очередь фонового обогащения. Ответ не ожидает её завершения. Пакетные запросы, персональные ключи и webhooks пока не реализованы.
Ошибки и частота запросов
400 — invalid_inn; 405 — method_not_allowed; 429 — rate_limited; 500 — internal_error. Ошибка содержит error.code и error.message, а data=null.
На сервере применяется ограничение 5 запросов в секунду на адрес с небольшим допустимым всплеском. При 429 учитывайте Retry-After и увеличивайте паузу. Не запускайте массовую проверку параллельными одиночными запросами.
Совместимость
Существующий /api_inn.php?inn=... продолжает работать в прежнем формате. У него своя внутренняя нумерация версии; API v1 — отдельный контракт. В версии 1 возможны дополнительные поля; потребитель должен игнорировать неизвестные поля. Несовместимые изменения потребуют новой версии. Денежные значения могут передаваться десятичными строками для сохранения точности.