API и интеграция

API Контрагенто позволяет получать данные о компаниях и ИП Беларуси в машиночитаемом формате. Вы можете интегрировать проверку контрагентов в вашу CRM, ERP или любой внутренний сервис.

API работает по HTTP/HTTPS (TLSv1.2+). Полная PDF-документация: contragento_api.pdf

Каждый запрос подписывается логином и md5-хешем пароля. Используйте логин и пароль от личного кабинета cab.contragento.by.

username — имя пользователя (УНП)
password — md5-хеш пароля

Важно: параметры передаются как query string (например, ?number=192802792), а не как JSON-объект.

Запрос информации по УНП:

GET api.contragento.by/api/check
number — int(9), обязательно — УНП организации

tax

taxInstitution → number (код ИМНС), title (наименование МНС)
shortName — краткое наименование согласно МНС
longName — полное наименование согласно МНС
status — статус согласно МНС
address — юридический адрес
egrDate — дата постановки на учёт в МНС
regDate — дата регистрации

egrn

shortName — краткое наименование согласно ЕГР
longName — полное наименование согласно ЕГР
firmName — фирменное наименование
executiveInstitution — регистрирующий орган
status — статус согласно ЕГР

isLiquidation

status — ликвидация (true/false)
date — дата начала ликвидации

risky

status — реестр лжепредпринимателей (true/false)
reason — причина добавления

riskyDFR

status — реестр ДФР КГК (true/false)
reason — причина добавления

bankruptcy

status — банкротство (true/false)
info → date, regulatory (управляющий), state

debts

Массив долгов перед бюджетом: debtor, period

phones / emails

Массивы известных телефонов и email-адресов