Документация

Примеры данных

Все организации, у которых есть ИНН, доступны по следующим ссылкам с ИНН:

Организации также доступны по ссылкам с ОГРН.

Все индивидуальные предприниматели, доступны по следующим ссылкам с ИНН физических лиц:

Индивидуальные предприниматели также доступны по ссылкам с ОГРНИП.

Получение связей по ИНН

Только для подписчиков. GET, ответ в JSON — список связанных идентификаторов из inn_id: /links/?inn=770300584079. Учёт в суточном (или месячном) лимите — по числу возвращённых записей.

Финансовые данные по ИНН

Только для подписчиков. GET, ответ в JSON — финансовые данные организации по ИНН (10 цифр): /fin/?inn=7730588444&year=2024. Параметр year (4 цифры) необязателен — без него возвращаются данные за все годы. Учёт в суточном (или месячном) лимите — по числу лет в ответе.

Ответ содержит по годам: income и outcome — доходы и расходы в рублях, tax — уплаченные налоги по видам, n — среднесписочную численность сотрудников, tax_system — применяемые налоговые режимы. Отдельно (без разбивки по годам) — tax_debt (задолженность по налогам: недоимка debt_s, пени peni_s, штрафы fine_s, всего s), msp (реестр малого и среднего предпринимательства) и support (меры поддержки).

Поле tax_system — битовая маска специальных налоговых режимов. Значение — сумма битов применяемых режимов:

0 — спецрежимов нет (ОСНО);
1 — ЕСХН;
2 — УСН;
4 — ЕНВД;
8 — СРП;
16 — АУСН;
32 — ПСН;
64 — НПД.

Например, "tax_system":"2" — УСН, а "tax_system":"3" — ЕСХН и УСН одновременно (1 + 2).

При запросе данных XML и JSON либо посылайте заголовок "Accept-encoding: gzip" либо добавляйте расширение .gz

Что и как отдаётся с какими расширениями и заголовками всегда можете посмотреть на нашем проекте Проверка HTTP-заголовков веб-сервера.

Примеры кода

Первый вариант с расширением .gz и без отправки заголовка Accept-encoding: gzip, но с декомпрессией на вашей стороне:

$content = gzdecode(file_get_contents('https://egrul.org/7730588444.json.gz'));
$json = json_decode($content,TRUE);
print_r($json);

Второй вариант с отправкой заголовка "Accept-encoding: gzip\r\n" и декомпрессией на вашей стороне:

$opts = [
    "http" => [
        "method" => "GET",
        "header" => "Accept-encoding: gzip\r\n"
    ]
];

$context = stream_context_create($opts);
$content = gzdecode(file_get_contents('https://egrul.org/7730588444.xml', false, $context));
$xml = simplexml_load_string($content, 'SimpleXMLElement', LIBXML_NOBLANKS);
$xml = json_decode(json_encode($xml),TRUE);
print_r($xml);

$content = gzdecode(file_get_contents('https://egrul.org/7730588444.json', false, $context));
$json = json_decode($content,TRUE);
print_r($json);

Третий вариант менее предпочтительный без расширения .gz, без отправки заголовка Accept-encoding: gzip и без декомпрессии тоже можно, но лучше так не делать, если нагрузка канала пойдёт к гигабиту, то всё же придётся данные сжимать, так как сжатие уменьшает их в 5 раз.

$content = file_get_contents('https://egrul.org/7730588444.json');
$json = json_decode($content,TRUE);
print_r($json);