↑ Все API

API: компании Казахстана

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

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

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

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

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

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

  • bin
  • name_ru
  • name_kz
  • fio
  • address_ru
  • address_kz

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

  • 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_kz
            
            
{ "query": "140440031745" }

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

  • bin

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

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

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

Фильтрация

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

{
    "query": "хен",
    "filters": [
        { "type": "FOREIGN_BRANCH" }
    ]
}

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

НазваниеОписание
valueНаименование организации + БИН (бизнес-идентификационный номер)
unrestricted_value= value
data.binБИН (бизнес-идентификационный номер)
data.registration_dateДата регистрации
data.status Статус организации
  ACTIVE       — действующая
  INACTIVE     — бездействующая
  LIQUIDATING  — ликвидируется
  LIQUIDATED   — ликвидирована
  SUSPENDED    — деятельность приостановлена
data.type Тип организации
  LEGAL                    — юридическое лицо
  BRANCH                   — филиал
  INDIVIDUAL               — ИП (личный)
  INDIVIDUAL_JOINT_VENTURE — ИП (совместный)
  FOREIGN_BRANCH           — филиал иностранного юрлица
data.name_ruНаименование на русском языке
data.name_kzНаименование на казахском языке
data.fioФИО руководителя
data.address_ruАдрес одной строкой на русском языке
data.address_kzАдрес одной строкой на казахском языке
data.address_settlement_ruАдрес населенного пункта на русском языке
data.address_settlement_kzАдрес населенного пункта на казахском языке
data.address_localАдрес внутри населенного пункта
data.okedКод основного вида деятельности
data.oked_name_ruНаименование основного вида деятельности на русском языке
data.oked_name_kzНаименование основного вида деятельности на казахском языке
data.krpКод размерности предприятия
data.krp_name_ruНаименование размерности предприятия на русском языке
data.krp_name_kzНаименование размерности предприятия на казахском языке
data.kseКод сектора экономики
data.kse_name_ruНаименование сектора экономики на русском языке
data.kse_name_kzНаименование сектора экономики на казахском языке
data.kfsКод формы собственности
data.kfs_name_ruНаименование формы собственности на русском языке
data.kfs_name_kzНаименование формы собственности на казахском языке

Источник данных: Бюро национальной статистики Республики Казахстан

Ограничения

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

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

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

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

Стоимость

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