Справочники
Страны
POST/v1/suggest/countryсовместимо с DaData: /suggestions/api/4_1/rs/suggest/country
Ищет по названию, числовому коду или коду ISO (alpha-2/alpha-3, например «RU» или «RUS»). Возвращает краткое и полное название и все три кода.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название страны, числовой код или код ISO. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/country // к нам
POST /suggestions/api/4_1/rs/suggest/country // совместимо с DaData
{ "query": "RU", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Массив найденных стран, отсортированный по релевантности запросу. |
| suggestions[].value | string | Краткое общеупотребимое название страны (например, «Россия»). |
| suggestions[].code | string | Цифровой код страны ISO 3166-1 numeric (например, «643»). |
| suggestions[].alfa2 | string | Двухбуквенный код страны ISO 3166-1 alpha-2 (например, «RU»). |
| suggestions[].alfa3 | string | Трёхбуквенный код страны ISO 3166-1 alpha-3 (например, «RUS»). |
| suggestions[].name | string | Полное официальное название страны (например, «Российская Федерация»). |
Валюты
POST/v1/suggest/currencyсовместимо с DaData: /suggestions/api/4_1/rs/suggest/currency
Ищет по буквенному коду (USD), числовому коду (840) или названию. Возвращает оба кода и символ.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Буквенный код, числовой код или название валюты. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/currency // к нам
POST /suggestions/api/4_1/rs/suggest/currency // совместимо с DaData
{ "query": "USD", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Массив найденных валют. Наиболее подходящие совпадения идут первыми. |
| suggestions[].value | string | Наименование валюты (например, «Доллар США»). |
| suggestions[].code | string | Буквенный код валюты по ISO 4217 (например, USD, RUB). |
| suggestions[].code_num | string | Числовой код валюты по ISO 4217 (например, «840» для доллара США). |
| suggestions[].symbol | string | Графический символ валюты (например, $, €, ₽). |
Классификаторы
ОКВЭД
POST/v1/suggest/okvedсовместимо с DaData: /suggestions/api/4_1/rs/suggest/okved2
Поиск кода вида деятельности по коду или описанию (ОКВЭД 2): код, наименование и раздел.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Код или наименование вида деятельности по ОКВЭД2. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/okved // к нам
POST /suggestions/api/4_1/rs/suggest/okved2 // совместимо с DaData
{ "query": "разработка по", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Список найденных видов деятельности, отсортированный по релевантности запросу. |
| suggestions[].value | string | Наименование вида деятельности. |
| suggestions[].code | string | Код вида деятельности по классификатору ОКВЭД2 (например, «62»). |
| suggestions[].section | string | Буква раздела верхнего уровня классификатора. Возможные значения: A — сельское, лесное хозяйство, охота, рыболовство и рыбоводство; B — добыча полезных ископаемых; C — обрабатывающие производства; D — обеспечение электроэнергией, газом и паром, кондиционирование воздуха; E — водоснабжение, водоотведение, сбор и утилизация отходов; F — строительство; G — торговля оптовая и розничная, ремонт автотранспорта; H — транспортировка и хранение; I — гостиницы и предприятия общественного питания; J — деятельность в области информации и связи; K — финансовая и страховая деятельность; L — операции с недвижимым имуществом; M — профессиональная, научная и техническая деятельность; N — административная деятельность и сопутствующие услуги; O — государственное управление, обеспечение военной безопасности, социальное обеспечение; P — образование; Q — деятельность в области здравоохранения и социальных услуг; R — деятельность в области культуры, спорта, организации досуга и развлечений; S — предоставление прочих видов услуг; T — деятельность домашних хозяйств как работодателей; U — деятельность экстерриториальных организаций и органов. |
ОКПД2
POST/v1/suggest/okpd2совместимо с DaData: /suggestions/api/4_1/rs/suggest/okpd2
Поиск продукции или услуги по коду или наименованию (ОКПД2). Возвращает код, наименование и раздел классификатора.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Код или наименование продукции либо услуги по ОКПД2. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/okpd2 // к нам
POST /suggestions/api/4_1/rs/suggest/okpd2 // совместимо с DaData
{ "query": "молоко", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи ОКПД2. |
| suggestions[].value | string | Наименование продукции или услуги. |
| suggestions[].code | string | Код по классификатору ОКПД2. |
| suggestions[].section | string | Буква раздела ОКПД2. |
ОКТМО
POST/v1/suggest/oktmoсовместимо с DaData: /suggestions/api/4_1/rs/suggest/oktmo
Поиск муниципального образования по названию или коду ОКТМО. Возвращает название и код.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название муниципального образования или код ОКТМО. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/oktmo // к нам
POST /suggestions/api/4_1/rs/suggest/oktmo // совместимо с DaData
{ "query": "казань", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи муниципальных образований. |
| suggestions[].value | string | Название муниципального образования. |
| suggestions[].code | string | Код ОКТМО. |
Классы МКТУ
POST/v1/suggest/mktuсовместимо с DaData: /suggestions/api/4_1/rs/suggest/mktu
Поиск товара или услуги по номеру класса или названию МКТУ. Возвращает класс, номер позиции и название на русском, английском и французском языках.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Номер класса, номер позиции или название товара либо услуги по МКТУ. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/mktu // к нам
POST /suggestions/api/4_1/rs/suggest/mktu // совместимо с DaData
{ "query": "программ", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи классификатора МКТУ. |
| suggestions[].value | string | Текст подсказки для отображения. |
| suggestions[].class | string | Номер класса МКТУ. |
| suggestions[].number | string | Номер позиции внутри класса. |
| suggestions[].name_ru | string | Наименование на русском языке. |
| suggestions[].name_en | string | Наименование на английском языке. |
| suggestions[].name_fr | string | Наименование на французском языке. Может быть null. |
Организации и места
Станции метро
POST/v1/suggest/metroсовместимо с DaData: /suggestions/api/4_1/rs/suggest/metro
Поиск станции метро по названию. Возвращает станцию, ветку, город и координаты.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название станции метро. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/metro // к нам
POST /suggestions/api/4_1/rs/suggest/metro // совместимо с DaData
{ "query": "арбат", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи станций метро. |
| suggestions[].value | string | Название станции. |
| suggestions[].city | string | Город, где находится станция. |
| suggestions[].line | string | Название ветки. |
| suggestions[].line_id | string | Номер ветки. |
| suggestions[].color | string | Цвет ветки в формате hex. |
| suggestions[].geo | object | Координаты станции. |
| suggestions[].geo.lat | number | Широта. |
| suggestions[].geo.lon | number | Долгота. |
| suggestions[].city_kladr_id | string | Код города по КЛАДР. |
| suggestions[].city_fias_id | string | Идентификатор города по ФИАС. |
| suggestions[].is_closed | bool | Признак закрытой станции. |
Налоговые инспекции
POST/v1/suggest/fns_unitсовместимо с DaData: /suggestions/api/4_1/rs/suggest/fns_unit
Поиск управления ФНС по названию, коду или региону. Возвращает название управления, код налогового органа и регион.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название, код или регион управления ФНС. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/fns_unit // к нам
POST /suggestions/api/4_1/rs/suggest/fns_unit // совместимо с DaData
{ "query": "омск", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные управления ФНС по субъектам РФ. |
| suggestions[].value | string | Название управления (например, «УФНС России по Омской области»). |
| suggestions[].code | string | Код налогового органа (4 цифры). |
| suggestions[].region | string | Код региона (2 цифры). |
Подразделения МВД
POST/v1/suggest/fms_unitсовместимо с DaData: /suggestions/api/4_1/rs/suggest/fms_unit
Поиск подразделения, выдавшего паспорт, по названию или коду. Возвращает название, код и регион подразделения.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код подразделения, выдавшего паспорт. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/fms_unit // к нам
POST /suggestions/api/4_1/rs/suggest/fms_unit // совместимо с DaData
{ "query": "гу мвд", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи подразделений. |
| suggestions[].value | string | Название подразделения, выдавшего паспорт. |
| suggestions[].code | string | Код подразделения. |
| suggestions[].region_code | string | Код региона. |
Суды
POST/v1/suggest/courtсовместимо с DaData: /suggestions/api/4_1/rs/suggest/court
Поиск суда по названию или коду. Возвращает название, код, регион и уровень суда.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код суда. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/court // к нам
POST /suggestions/api/4_1/rs/suggest/court // совместимо с DaData
{ "query": "алтайский", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи по запросу. |
| suggestions[].value | string | Название суда. |
| suggestions[].code | string | Код суда. |
| suggestions[].region | string | Код региона. |
| suggestions[].level | string | Уровень суда: regional (региональный), district (районный), arbitration (арбитражный). |
Таможни
POST/v1/suggest/customsсовместимо с DaData: /suggestions/api/4_1/rs/suggest/fts_unit
Поиск таможенного органа по названию или коду. Возвращает реквизиты, контакты и режим работы.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код таможенного органа. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/customs // к нам
POST /suggestions/api/4_1/rs/suggest/fts_unit // совместимо с DaData
{ "query": "алтайская", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи таможенных органов. |
| suggestions[].value | string | Название таможенного органа для показа. |
| suggestions[].code | string | Код таможенного органа. |
| suggestions[].name | string | Полное наименование. |
| suggestions[].name_short | string | Краткое наименование. |
| suggestions[].head | string | Начальник таможенного органа; null, если в реестре не указан. |
| suggestions[].kind | string | Тип органа: таможня (customs) или пост (post). |
| suggestions[].inn | string | ИНН организации. |
| suggestions[].ogrn | string | ОГРН организации. |
| suggestions[].okpo | string | Код по ОКПО. |
| suggestions[].address | string | Почтовый адрес. |
| suggestions[].phone | string | Телефон. |
| suggestions[].fax | string | Факс. |
| suggestions[].email | string | Адрес электронной почты. |
| suggestions[].website | string | Сайт. |
| suggestions[].schedule | string | Часы работы. |
| suggestions[].region | string | Код региона. |
Почтовые отделения
POST/v1/suggest/postal_officeсовместимо с DaData: /suggestions/api/4_1/rs/suggest/postal_unit
Поиск почтового отделения по индексу, названию или городу. Возвращает индекс, название, регион и адрес отделения.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Почтовый индекс, название отделения или город. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/postal_office // к нам
POST /suggestions/api/4_1/rs/suggest/postal_unit// совместимо с DaData
{ "query": "101000", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи почтовых отделений. |
| suggestions[].value | string | Готовая строка с индексом и городом для отображения. |
| suggestions[].code | string | Почтовый индекс отделения. |
| suggestions[].name | string | Название отделения. |
| suggestions[].region | string | Регион расположения отделения. |
| suggestions[].address | string | Адрес отделения. |
Профессии и прочее
ОКПДТР: профессии
POST/v1/suggest/okpdtr_professionсовместимо с DaData: /suggestions/api/4_1/rs/suggest/okpdtr_profession
Поиск рабочей профессии по названию или коду ОКПДТР. Возвращает код профессии, код и название группы по ОКЗ.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код рабочей профессии по ОКПДТР. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/okpdtr_profession // к нам
POST /suggestions/api/4_1/rs/suggest/okpdtr_profession// совместимо с DaData
{ "query": "токарь", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи рабочих профессий. |
| suggestions[].value | string | Наименование профессии. |
| suggestions[].code | string | Код профессии по ОКПДТР. |
| suggestions[].etks_code | string | Код выпуска ЕТКС. |
| suggestions[].okz_code | string | Код группы по ОКЗ. |
| suggestions[].okz_name | string | Название группы по ОКЗ. |
| suggestions[].grade_range | string | Диапазон разрядов профессии. |
ОКПДТР: должности
POST/v1/suggest/okpdtr_positionсовместимо с DaData: /suggestions/api/4_1/rs/suggest/okpdtr_position
Поиск должности служащего по названию или коду ОКПДТР. Возвращает код должности, код и название группы по ОКЗ.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код должности служащего по ОКПДТР. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/okpdtr_position // к нам
POST /suggestions/api/4_1/rs/suggest/okpdtr_position// совместимо с DaData
{ "query": "бухгалтер", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи по запросу. |
| suggestions[].value | string | Наименование должности служащего. |
| suggestions[].code | string | Код должности по ОКПДТР. |
| suggestions[].okz_code | string | Код группы по ОКЗ. |
| suggestions[].okz_name | string | Наименование группы по ОКЗ. |
Медицинские должности
POST/v1/suggest/medical_positionсовместимо с DaData: /suggestions/api/4_1/rs/suggest/medical_position
Поиск медицинской должности по названию или коду. Возвращает код, категорию и группу должности.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код медицинской должности. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/medical_position // к нам
POST /suggestions/api/4_1/rs/suggest/medical_position// совместимо с DaData
{ "query": "хирург", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи о медицинских должностях. |
| suggestions[].value | string | Наименование должности. |
| suggestions[].code | string | Код должности. |
| suggestions[].category | string | Категория должности. |
| suggestions[].group | string | Группа должности. |
Марки автомобилей
POST/v1/suggest/car_brandсовместимо с DaData: /suggestions/api/4_1/rs/suggest/car_brand
Поиск марки автомобиля по названию или коду. Возвращает код марки, название на русском языке и страну-производителя.
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
| queryrequired | string | Название или код марки автомобиля. |
| count | integer | Сколько подсказок вернуть (1–20, по умолчанию 10). |
POST /v1/suggest/car_brand // к нам
POST /suggestions/api/4_1/rs/suggest/car_brand// совместимо с DaData
{ "query": "toyota", "count": 1 }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Найденные записи марок автомобилей. |
| suggestions[].value | string | Название марки. |
| suggestions[].code | string | Код марки. |
| suggestions[].name_ru | string | Название марки по-русски. |
| suggestions[].country | string | Страна-производитель. |