↑ Все API

API: компании Беларуси

Справочник организаций и индивидуальных предпринимателей Беларуси.

Чтобы вызвать метод, и подтвердите почту.

Полнотекстовый поиск (suggest)

Пример запроса:

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party_by
            
            
{ "query": "онлайнер" }

Поиск работает по полям:

  • unp
  • full_name_ru
  • full_name_by
  • short_name_ru
  • short_name_by
  • trade_name_ru
  • trade_name_by
  • address

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

Запись справочника по идентификатору (findById)

Пример запроса:

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party_by
            
            
{ "query": "190657494" }

Выборка по идентификатору работает по полям:

  • unp

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

Фильтрация

Фильтрация работает по полям status (статус организации) и type (тип организации):

{
    "query": "лар",
    "filters": [
        { "status": "LIQUIDATED" }
    ]
}
{
    "query": "лар",
    "filters": [
        { "type": "INDIVIDUAL" }
    ]
}

Поля справочника

НазваниеОписание
valueНаименование организации + УНП (учетный номер налогоплательщика)
unrestricted_value= value
data.unpУНП (учетный номер налогоплательщика)
data.registration_dateДата регистрации
data.removal_dateДата исключения из ЕГР
data.actuality_dateДата последних изменений
data.status Статус организации
  ACTIVE       — действующая
  LIQUIDATING  — ликвидируется
  LIQUIDATED   — ликвидирована
  BANKRUPT     — банкротство
  SUSPENDED    — деятельность приостановлена
  REORGANIZING — в процессе присоединения к другому
                 юрлицу, с последующей ликвидацией
data.type Тип организации
  INDIVIDUAL   — индивидуальный предприниматель
  LEGAL        — юридическое лицо
data.full_name_ruПолное наименование на русском языке
data.full_name_byПолное наименование на белорусском языке
data.short_name_ruКраткое наименование на русском языке
data.short_name_byКраткое наименование на белорусском языке
data.trade_name_ruТорговое наименование на русском языке (только для юрлиц)
data.trade_name_byТорговое наименование на белорусском языке (только для юрлиц)
data.fio_ruФИО на русском языке (только для ИП)
data.fio_byФИО на белорусском языке (только для ИП)
data.addressАдрес местонахождения одной строкой на русском языке (только для юрлиц)
data.okedКод основного вида деятельности
data.oked_nameНаименование основного вида деятельности на русском языке

Источник данных: Единый государственный регистр юрлиц и ИП Беларуси

Примеры вызова

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.