Русский · English
Готовые примеры работы с API ЕГРЮЛ/ЕГРИП на шести языках: Python, TypeScript (Node.js), Go, Java, C#, PHP. Получить карточку организации или ИП по ИНН, ОГРН или ОГРНИП, найти компанию по названию, скачать официальную выписку из реестра в PDF.
Каждый пример запускается сразу — без регистрации, без ключа, без карты. В коде зашит публичный демо-ключ.
git clone https://github.com/atlorium-api/egrul-api-client
cd egrul-api-client/python && pip install -r requirements.txt && python main.pyОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ «БОБЫЛЕВА, ВИНОГРАДОВ AND ЕГОРОВА»
ИНН 7707083893 · ОГРН 1464718083827
Статус: Действующая организация
Адрес: 125098, Г.МОСКВА, УЛ. ЗАПАДНАЯ ПРОСПЕКТ, Д. 60
Основной ОКВЭД: 62.01 — Разработка компьютерного программного обеспечения
Руководитель: ГЕНЕРАЛЬНЫЙ ДИРЕКТОР — АНЖЕЛИКА ВОЛКОВА
Стоп-факторов не обнаружено.
[i] Реестр МСП: Микропредприятие
[i] Налоговые режимы: УСН
Демо-ключ отвечает правдоподобными моками, а не реальными данными реестра — поэтому названия в примере выше выглядят сгенерированными. Так и задумано: интеграцию можно написать и протестировать до оплаты. Подставьте боевой ключ — тот же код начнёт возвращать настоящие данные ФНС.
Проверка контрагента перед сделкой, обогащение CRM, автозаполнение реквизитов в формах, KYB-скоринг, антифрод. Вместо ручного поиска на сайте ФНС — один HTTP-запрос.
Примеры не просто печатают JSON, а применяют данные: в каждом есть функция assessCounterparty(), которая по карточке выносит вердикт — ликвидирована ли организация, не адрес ли это массовой регистрации, не минимальный ли уставный капитал, нет ли записей о недостоверности сведений.
Проверить API вообще без клонирования:
curl -H "Authorization: Bearer ak_sandbox_demo_mockdata_v1" \
"https://atlorium.com/api/egrul/7707083893"| Язык | Запуск | Требуется |
|---|---|---|
| Python | pip install -r requirements.txt && python main.py |
Python 3.10+ |
| TypeScript / Node.js | npm install && npm start |
Node.js 20+ |
| Go | go run . |
Go 1.22+ |
| Java | java Main.java |
JDK 17+ (без зависимостей) |
| C# | dotnet run |
.NET 8+ |
| PHP | php main.php |
PHP 8.1+ |
Передать свой ИНН аргументом: python main.py 7736207543
Ключ передаётся в заголовке Authorization:
Authorization: Bearer ВАШ_КЛЮЧ
| Ключ | Что делает |
|---|---|
ak_sandbox_demo_mockdata_v1 |
Демо-ключ. Публичный, один на всех. Возвращает моки, денег не списывает, регистрации не требует. Ответы детерминированы — на них можно писать стабильные тесты. |
| Боевой ключ | Реальные данные ФНС. Получить в личном кабинете: atlorium.com |
Переход на боевой ключ не требует правок в коде — все примеры читают переменную окружения:
export ATLORIUM_API_KEY="ak_ваш_боевой_ключ"Каждый ответ песочницы помечен заголовком X-Atlorium-Sandbox: true — перепутать мок с реальными данными невозможно.
Базовый адрес: https://atlorium.com
| Метод | Путь | Назначение |
|---|---|---|
GET |
/api/egrul/{query} |
Карточка организации или ИП по ИНН / ОГРН / ОГРНИП |
GET |
/api/egrul/search |
Поиск по наименованию организации или ФИО предпринимателя |
GET |
/api/egrul/{query}/excerpt |
Официальная выписка из реестра в формате PDF |
| Параметр | Где | Тип | Описание |
|---|---|---|---|
query |
путь | string | ИНН (10 цифр у ЮЛ, 12 у ИП), ОГРН (13 цифр) или ОГРНИП (15 цифр) |
extended |
query | bool | Расширенные сведения из официальной выписки. Для ЮЛ — состав участников и их доли; для ИП — e-mail и пол. По умолчанию false. Тарифицируется отдельно, отвечает медленнее. |
| Параметр | Где | Тип | Описание |
|---|---|---|---|
query |
query | string | Часть наименования организации или ФИО ИП. Например, Сбербанк |
limit |
query | int | Максимум результатов: по умолчанию 10, максимум 50 |
| Поле | Тип | Что содержит |
|---|---|---|
found |
bool | Найден ли субъект в реестре |
kind |
string | LegalEntity — юрлицо, SoleProprietor — ИП |
inn / ogrn / kpp |
string | Основные идентификаторы |
fullName / shortName |
string | Полное и сокращённое наименование |
status |
string | Текстовый статус: действующая, в стадии ликвидации, ликвидирована |
active |
bool | Ключевое поле для проверки. Действует ли организация |
registrationDate |
date | Дата регистрации |
address |
string | Юридический адрес |
regionCode / regionName |
string | Регион регистрации |
primaryOkved |
object | Основной вид деятельности: { code, name } |
additionalOkveds |
array | Дополнительные ОКВЭД |
authorizedCapital |
number | Уставный капитал, ₽ |
managers |
array | Руководители: { fullName, inn, position } |
founders |
array | Учредители (только при extended=true) |
specialTaxRegimes |
array | Налоговые режимы: УСН, ЕСХН, АУСН |
smeCategory |
string | Категория в реестре МСП: микро / малое / среднее |
massAddress |
bool | Признак риска. Адрес массовой регистрации |
publications |
array | Записи о недостоверности сведений, предстоящем исключении |
officialExcerptAvailable |
bool | Доступна ли PDF-выписка |
dataDate |
date | На какую дату актуальны данные |
Для ИП вместо fullName заполняются lastName, firstName, middleName, citizenship, а при extended=true — gender и email.
| Код | Причина | Что делать |
|---|---|---|
400 |
Неверный формат идентификатора | Проверьте: ИНН 10 или 12 цифр, ОГРН 13, ОГРНИП 15 |
401 |
Ключ отсутствует, просрочен или недействителен | Проверьте заголовок Authorization |
402 |
Недостаточно кредитов на балансе | Пополнить на atlorium.com |
404 |
Субъект не найден в реестре | Идентификатор корректен, но такой записи нет |
429 |
Превышен rate-limit | Повторить с задержкой |
503 |
Реестр временно недоступен | Повторить позже. За сбой на нашей стороне деньги не списываются |
Во всех шести примерах коды разложены в человекочитаемые причины — смотрите класс AtloriumError.
Оплата pay-as-you-go, без подписки: платите только за выполненные запросы. Актуальные тарифы и лимиты — на atlorium.com/pricing.
Актуальные цены и лимиты: atlorium.com/pricing
Откуда данные? Из публичных государственных реестров ЕГРЮЛ/ЕГРИП ФНС России, вживую на момент запроса.
Чем это отличается от сайта ФНС? Тем же данным придана машиночитаемая форма: структурированный JSON вместо HTML-страницы, плюс поиск по названию и PDF-выписка одним запросом.
Можно ли получить выписку с ЭЦП? Да — эндпоинт /excerpt возвращает официальную выписку из реестра в PDF.
Обязательна ли регистрация, чтобы попробовать? Нет. Демо-ключ публичный и работает без аккаунта — но возвращает моки, а не реальные данные.
Что означает extended=true? Дополнительная обработка официальной выписки: для ЮЛ извлекается состав участников и их доли, для ИП — e-mail и пол. Тарифицируется отдельно.
Есть ли SDK-пакет в PyPI/npm? Пока нет — это самодостаточные примеры без зависимостей, чтобы их можно было скопировать в свой проект целиком.
Проверка контрагента редко бывает единственной задачей. Из того же аккаунта и тем же ключом доступны:
- Справочник БИК ЦБ РФ — реквизиты банка и контрольный ключ расчётного счёта
- Распознавание текста с картинки — OCR по изображению или Base64
- SWIFT/BIC — разбор кода по ISO-9362 и сверка перед международным переводом
- ИИ-чат — модели, сессии, суммаризация текста
- Проверка BIN карты — банк-эмитент, страна и тип карты для антифрода на чекауте
- Проверка почты — синтаксис, MX-записи, одноразовые адреса
Полный каталог — atlorium.com
- Документация API (Swagger): atlorium.com/egrulAPI
- Описание сервиса: atlorium.com/egrulDescription
- Веб-интерфейс: atlorium.com/egrulGUI
- OpenAPI-спецификация: egrul_ru.json
- Поддержка: support@atlorium.com
MIT — берите код и используйте как хотите, в том числе в коммерческих проектах.