↑ Все API

API: налоговые инспекции

Справочник инспекций Налоговой службы.

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

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

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/fns_unit
            
            
{ "query": "нижнего" }

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

  • code
  • name_short
  • 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/fns_unit
            
            
{ "query": "5257" }

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

  • code
  • inn

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

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

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

Фильтрация

Фильтрация работает по полю region_code (первые 2 цифры КЛАДР-кода региона):

{
    "query": "ленинск",
    "filters": [{"region_code": "58"}]
}

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

НазваниеОписание
valueЗначение одной строкой (как показывается в списке подсказок)
unrestricted_value= value
data.codeКод инспекции
data.nameПолное название
data.name_shortКраткое название
data.addressАдрес
data.phoneТелефоны
data.commentОКПО и режим работы
data.payment_nameПолучатель платежа
data.oktmoКоды ОКТМО бюджетополучателя
data.innИНН получателя
data.kppКПП получателя
data.bank_nameНазвание банка получателя
data.bank_bicБИК банка получателя
data.bank_correspondent_accountКорсчет банка получателя
data.bank_accountНомер счёта получателя
data.parent_codeКод регистрирующей инспекции
data.parent_nameПолное название регистрирующей инспекции
data.parent_addressАдрес регистрирующей инспекции
data.parent_phoneТелефоны регистрирующей инспекции
data.parent_commentРежим работы регистрирующей инспекции

Источник данных: Федеральная налоговая служба

Ограничения

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

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

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

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

Стоимость

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