party_by

---

Подсказки по организациям Беларуси

POST

/suggest/party_by

Подсказки по справочнику организаций и индивидуальных предпринимателей Беларуси
Поиск выполняется по полям:

• unp
• full_name_ru
• full_name_by
• short_name_ru
• short_name_by
• trade_name_ru
• trade_name_by
• address

Авторизация

ApiKey

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

Тип

API Key (header: Authorization)

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

application/json

object

См. https://dadata.ru/api/suggest/party_by/

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

Макс. длина300

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

Минимум1

Максимум20

По умолчанию10

object[]

Фильтрация работает по полям status (статус организации) и type (тип организации).

Если заданы оба параметра (status и type), необходимо передавать не отдельные объекты с одним полем,
а массив объектов, представляющий декартово произведение всех комбинаций type и status.

❌ Неправильно:
[{ type: 'LEGAL' }, { status: 'BANKRUPT' }, { status: 'SUSPENDED' }]

✅ Правильно:
[{ type: 'LEGAL', status: 'BANKRUPT' }, { type: 'LEGAL', status: 'SUSPENDED' }]

Статус организации

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

Тип организации

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

Ответы API

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

Content-Type

application/json

object

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

object[]

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

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

Наименование организации + УНП (учетный номер налогоплательщика)

То же, что и value

object

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

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