Skip to content

Подсказки по организациям

POST
/suggest/party

Ищет компании и индивидуальных предпринимателей:

  • по ИНН, ОГРН и КПП;
  • названию (полному и краткому);
  • ФИО (для индивидуальных предпринимателей);
  • ФИО руководителя компании;
  • адресу до улицы
Ссылки на официальную документацию:
https://dadata.ru/api/suggest/party/https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669122https://dadata.ru/suggestions/usage/party/

Авторизация

ApiKey

API-ключ. Полный вид заголовка: Authorization: Token <YOUR_KEY>. Получить ключ

Тип
API Key (header: Authorization)

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

application/json
object

Текст запроса.
@maxLength 300

Макс. длина300

Максимальное количество результатов.
@minimum 1
@maximum 20
@default 10

Минимум1
Максимум20
По умолчанию10

Фильтр по типу организации. API принимает одно из двух значений в виде строки:

  • LEGAL - юрлицо
  • INDIVIDUAL - ИП

https://confluence.hflabs.ru/pages/viewpage.action?pageId=206176337

Возможные значения"LEGAL""INDIVIDUAL"
string[]

Фильтр по статусу организации. API принимает массив. Например:

  • действующие: ["ACTIVE"]
  • ликвидируемые и ликвидированные: ["LIQUIDATING", "LIQUIDATED"]

https://confluence.hflabs.ru/pages/viewpage.action?pageId=206176335

Возможные значения"ACTIVE""BANKRUPT""LIQUIDATED""LIQUIDATING""REORGANIZING"
string |array

Фильтр по типу филиала

  • MAIN - искать только по головным организациям
  • BRANCH - искать только по филиалам
Любой из:
Возможные значения"MAIN""BRANCH"
string[]
Возможные значения"MAIN""BRANCH"

Фильтр по коду ОКВЭД. API принимает массив вида ["07.1", "07.10", "07.2", "07.21"]

https://confluence.hflabs.ru/pages/viewpage.action?pageId=1093075333

object[]

Фильтр по региону (двузначный код).
API принимает массив вида { kladr_id: string }[]

https://confluence.hflabs.ru/pages/viewpage.action?pageId=204669123

object[]

Приоритет города при ранжировании.
API принимает массив вида { kladr_id: string }[]

https://confluence.hflabs.ru/pages/viewpage.action?pageId=285343852

Ответы API

Запрос успешно обработан

application/json
object

Объект с массивом подсказок

object[]
Обязательный

Массив подсказок или пустой массив

Краткое наименование организации (data.name.short_with_opf).
Если краткое наименование не указано — полное наименование (data.name.full_with_opf)

Краткое наименование организации (То же, что и value)

object
Обязательный

Подробности об организации

Песочница

Сервер
Авторизация
Тело запроса

Примеры кода

Создано с помощью VitePress OpenAPI