API — Поиск

Поиск компаний и индивидуальных предпринимателей по наименованию, учредителям, руководителям, кодам ОКВЭД-2, датам регистрации или обновления.



Формат запроса

Используются POST- или GET-запросы следующего вида

https://api.ofdata.ru/v2/search?key=API-ключ&параметры запроса


Параметр запроса Описание
by
Обязательный параметр
Определяет тип поиска, принимает следующие значения:
by=name
для поиска по наименованию компании или ФИО предпринимателя,
by=founder-name
для поиска по ФИО учредителя или наименованию компании-учредителя,
by=leader-name
для поиска по ФИО руководителя,
by=okved
для поиска по коду ОКВЭД-2 основного вида деятельности,
by=reg-date
для поиска по дате регистрации,
by=upd-date
для поиска по дате обновления выписки ЕГРЮЛ или ЕГРИП.
obj
Обязательный параметр
Определяет область поиска, принимает следующие значения:
obj=org
для поиска по компаниям,
obj=ent
для поиска по индивидуальным предпринимателям.
query
Обязательный параметр
Текст поискового запроса. Минимальное количество символов для поиска по наименованию или ФИО: 4. Для поиска по дате регистрации или обновления, используйте формат даты
YYYY-MM-DD
.
region
Код региона компании или ИП, состоящий из 2 цифр.
okved
Код основного вида деятельности компании или ИП согласно ОКВЭД-2. Параметр не применяется при поиске типа
by=okved
.
opf
Код организационно-правовой формы компании, состоящий из 2 или 5 цифр согласно классификатору ОКОПФ. Параметр не применяется при поиске типа
by=name
и при поиске по предпринимателям
obj=ent
.
active
При указании параметра
active=true
в результатах поиска будут только активные компании или ИП.
limit
Ограничение количества результатов поиска на одну страницу. Значение по умолчанию: 100, максимальное значение: 100.
page
Номер страницы. Если количество результатов поиска превышает значение
limit
, результаты будут разбиты на несколько страниц и вы сможете использовать данный параметр для просмотра нужной страницы.

Примеры запросов
https://api.ofdata.ru/v2/search?key=API-ключ&by=name&obj=org&query=пао ростелеком

https://api.ofdata.ru/v2/search?key=API-ключ&by=name&obj=ent&query=морозов андрей&region=40

https://api.ofdata.ru/v2/search?key=API-ключ&by=founder-name&obj=org&query=нуралиев борис

https://api.ofdata.ru/v2/search?key=API-ключ&by=leader-name&obj=org&query=греф герман оскарович&region=77

https://api.ofdata.ru/v2/search?key=API-ключ&by=okved&obj=org&query=63.11&opf=12300&active=true

https://api.ofdata.ru/v2/search?key=API-ключ&by=reg-date&obj=org&query=2021-12-09&okved=63.11

https://api.ofdata.ru/v2/search?key=API-ключ&by=upd-date&obj=org&query=2022-01-27


Примечания


Формат ответа

Для поиска по компаниям
{
  data: {
Результаты поиска
    СтрВсего: <INTEGER>,
Количество страниц с результатами поиска
    СтрТекущ: <INTEGER>,
Номер текущей страницы
    Записи: [ {
Компании
      ОГРН: <STRING>,
ОГРН
      ИНН: <STRING>,
ИНН
      КПП: <STRING>,
КПП
      НаимСокр: <STRING>,
Сокращенное наименование
      НаимПолн: <STRING>,
Полное наименование
      ДатаРег: <STRING>,
Дата регистрации
      Статус: <STRING>,
Статус
      ДатаЛикв: <STRING>,
Дата ликвидации
      РегионКод: <STRING>,
Код региона РФ
      ЮрАдрес: <STRING>,
Юридический адрес
      ОКВЭД: <STRING>
Основной вид деятельности согласно ОКВЭД
    }, ... ],
  },
  meta: {
Информация о результате запроса
    status: <STRING>,
Статус ответа, принимает значения "ok" или "error"
    today_request_count: <INTEGER>,
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
    message: <STRING>
Сообщение, поясняющее результат запроса, отсутствует в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
  }
}
Для поиска по индивидуальным предпринимателям
{
  data: {
Результаты поиска
    СтрВсего: <INTEGER>,
Количество страниц с результатами поиска
    СтрТекущ: <INTEGER>,
Номер текущей страницы
    Записи: [ {
Индивидуальные предприниматели
      ОГРНИП: <STRING>,
ОГРНИП
      ИНН: <STRING>,
ИНН
      ФИО: <STRING>,
Ф. И. О.
      Тип: <STRING>,
Наименование типа ИП
      ДатаРег: <STRING>,
Дата регистрации
      Статус: <STRING>,
Статус
      ДатаПрекращ: <STRING>,
Дата прекращения деятельности
      РегионКод: <STRING>,
Код региона РФ
      ОКВЭД: <STRING>
Основной вид деятельности согласно ОКВЭД
    }, ... ],
  },
  meta: {
Информация о результате запроса
    status: <STRING>,
Статус ответа, принимает значения "ok" или "error"
    today_request_count: <INTEGER>,
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
    message: <STRING>
Сообщение, поясняющее результат запроса, отсутствует в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
  }
}
Перейти к тарифным планам