Skip to content

Suggest Party

POST
/suggest/party

If you're interested in the English version of this spec, let us know on the GitHub.

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

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

Authorizations

ApiKey

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

Type
API Key (header: Authorization)

Request Body

application/json
object

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

Max Length300

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

Minimum1
Maximum20
Default10

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

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

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

Valid values"LEGAL""INDIVIDUAL"
string[]

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

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

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

Valid values"ACTIVE""BANKRUPT""LIQUIDATED""LIQUIDATING""REORGANIZING"
string |array

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

  • MAIN - искать только по головным организациям
  • BRANCH - искать только по филиалам
Any of
Valid values"MAIN""BRANCH"
string[]
Valid values"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

Responses

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

application/json
object

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

object[]
Required

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

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

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

object
Required

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

Playground

Server
Authorization
Body

Samples

Powered by VitePress OpenAPI