Skip to content

Find Party

POST
/findById/party

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

Находит компанию или ИП по ИНН или ОГРН.
Возвращает все доступные сведения о компании, в отличие от метода suggest, который возвращает только базовые поля.

Official documentation:
https://dadata.ru/api/find-party/https://confluence.hflabs.ru/pages/viewpage.action?pageId=568918058

Authorizations

ApiKey

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

Type
API Key (header: Authorization)

Request Body

application/json
object

ИНН или ОГРН.

Также поддерживается поиск по КПП, однако налоговая не сообщает КПП для ~25% компаний,
эти компании найти по КПП не получится

@maxLength 300

Max Length300

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

Default10
Maximum20

КПП организации

  • для ~25% компаний налоговая не сообщает КПП филиалов

@example { "query": "7707083893", "kpp": "540602001" }

Головная организация (MAIN) или филиал (BRANCH).

@example { "query": "7707083893", "branch_type": "MAIN" }

Valid values"MAIN""BRANCH"

Юрлицо (LEGAL) или индивидуальный предприниматель (INDIVIDUAL)
@example {"query": "7707083893","type": "LEGAL"} // Юрлица
@example {"query": "784806113663","type": "INDIVIDUAL"} // Индивидуальные предприниматели

Valid values"LEGAL""INDIVIDUAL"
string[]

Ограничение по статусу организации

Valid values"ACTIVE""BANKRUPT""LIQUIDATED""LIQUIDATING""REORGANIZING"

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