curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_registry" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_registry",
"service_name": "Brazil - Company Registry Lookup (CNPJ)",
"source_data": {
"company_name": "EMPRESA EXEMPLO LTDA",
"company_status": "ATIVA",
"company_status_date": "2025-01-10",
"headquarters_state": "SP",
"legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
"main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"main_activity_code": "6201501",
"registration_date": "2010-03-15",
"registration_number": "11222333000181",
"trade_name": "EXEMPLO"
},
"validation": {}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "bra_company_registry",
"service_name": "Brazil - Company Registry Lookup (CNPJ)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {}
}
]
}
🇧🇷 Бразилия
Реестр компаний Бразилии (CNPJ) — API проверки
Проверка по реестру компаний Бразилии (CNPJ) через Didit: данные из авторитетной базы. Оплата за вызов от $0.20, без контрактов и минимумов.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_registry" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_registry",
"service_name": "Brazil - Company Registry Lookup (CNPJ)",
"source_data": {
"company_name": "EMPRESA EXEMPLO LTDA",
"company_status": "ATIVA",
"company_status_date": "2025-01-10",
"headquarters_state": "SP",
"legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
"main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"main_activity_code": "6201501",
"registration_date": "2010-03-15",
"registration_number": "11222333000181",
"trade_name": "EXEMPLO"
},
"validation": {}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "bra_company_registry",
"service_name": "Brazil - Company Registry Lookup (CNPJ)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {}
}
]
}
Ищет бразильскую компанию по CNPJ в реестре Receita Federal: юридическое и торговое наименование, статус регистрации, дату основания, организационно-правовую форму, основной вид деятельности и штат головного офиса. Didit предоставляет эту услугу через
POST /v3/database-validation/, чтобы вы могли сверить переданные данные с авторитетным источником и получить нормализованные результаты сопоставления.
Покрытие
- Покрытие: ~ 100%
- Страна: Бразилия
- ID услуги:
bra_company_registry - Область данных: Государственные данные
- Категория: CompanyRegister
Входные данные
| Поле | Обязательное | Пример |
|---|---|---|
company_registration_number | Да | 11222333000181 |
vendor_data | Нет | user-1234 |
- Обязательные входные данные:
company_registration_number - Необязательные входные данные:
vendor_data - Согласие: не требуется
- Доступность в сценарии: доступно в сценарии с сопоставлением полей
- Покрытие: ~ 100%
- Цена: $0.20 за успешный запрос
company_registration_number не печатается на удостоверении личности, поэтому ни один шаг не создаёт его сам по себе. Получите его из ответа в анкете, из поля, извлечённого с помощью Document AI, или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге проверки по базам данных. Пока поле не сопоставлено, редактор сценария показывает эту услугу как отключённую и называет недостающий входной параметр. Во время выполнения отсутствующий входной параметр означает, что проверка пропускается до любого запроса, поэтому с вас не взимается плата за базу данных, по которой не удалось выполнить запрос.
Параметры тела запроса
string
по умолчанию:"BRA"
обязательно
Код страны ISO 3166-1 alpha-3 для этой услуги проверки по базе данных.Пример:
BRAstring
по умолчанию:"bra_company_registry"
обязательно
Массив, содержащий этот ID услуги. Закрепление услуги ограничивает запрос именно этой базой данных.Пример:
bra_company_registrystring
по умолчанию:"11222333000181"
обязательно
Значение
company_registration_number, обязательное для этой услуги проверки по базе данных.Пример: 11222333000181string
по умолчанию:"user-1234"
Ваш постоянный идентификатор этого пользователя, например внутренний ID пользователя. Didit использует его, чтобы связывать отдельные проверки с одним и тем же конечным пользователем и уменьшать количество ложных срабатываний при поиске дубликатов.Пример:
user-1234Правила ввода и примечания по валидации
company_registration_numberдолжен соответствовать шаблону[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}.
Как вызвать
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_registry" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
Каждый успешный вызов возвращает HTTP 200. Поле outcome_code сообщает, что именно произошло, например позволяя отличить реальное несовпадение биометрии (BIOMETRIC_NO_MATCH) от селфи, которое не удалось прочитать (BIOMETRIC_IMAGE_UNUSABLE). Показанный status представляет собой статус функции по умолчанию; ваши настроенные действия Partial Match / No Match могут его переопределить.MATCH: Реестр подтвердил личность, и все проверенные поля совпали.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_registry",
"service_name": "Brazil - Company Registry Lookup (CNPJ)",
"source_data": {
"company_name": "EMPRESA EXEMPLO LTDA",
"company_status": "ATIVA",
"company_status_date": "2025-01-10",
"headquarters_state": "SP",
"legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
"main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
"main_activity_code": "6201501",
"registration_date": "2010-03-15",
"registration_number": "11222333000181",
"trade_name": "EXEMPLO"
},
"validation": {}
}
]
}
DOCUMENT_NOT_FOUND: Переданный номер документа не соответствует ни одной записи в реестре.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "BRA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "DOCUMENT_NOT_FOUND",
"service_id": "bra_company_registry",
"service_name": "Brazil - Company Registry Lookup (CNPJ)",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {}
}
]
}
Возвращаемые данные
Точный набор полей, которые выводятся вsource_data, зависит от того, что возвращает реестр. Сгенерированный пример для bra_company_registry сейчас описывает такую нормализованную структуру:
company_namecompany_statuscompany_status_dateheadquarters_stateidentification_numberlegal_naturemain_activitymain_activity_coderegistration_dateregistration_numbertrade_name
Цены и SLA
Запросы в реестр компаний Бразилии (CNPJ) оплачиваются только тогда, когда Didit получает окончательный результат от источника проверки.- Цена за вызов: $0.20 USD.
- Оплата: за успешный запрос. Плата не взимается, если реестр недоступен, если не хватает обязательных полей или если запрос отклонён до обращения к источнику.
- Задержка: типичный p95 < 2 с.
- Доступность: 99.9% за квартал со стороны Didit; доступность источника данных зависит от страны и набора данных.
Что почитать дальше
Последнее изменение 7 ноября 2026 г.