A Prometiam é uma API REST com dados dos registros oficiais de empresas de 27 países. Para o Brasil, você recebe em um único objeto JSON os dados do Cadastro Nacional da Pessoa Jurídica (CNPJ) da Receita Federal: razão social, natureza jurídica, situação cadastral, endereço e CNAE.
Quem integra uma consulta de CNPJ ao cadastro de clientes, ao contas a pagar ou ao onboarding costuma encontrar duas opções: abrir o portal da Receita e copiar o resultado à mão, ou chamar uma API pública gratuita e aceitar os limites de requisições e as condições de disponibilidade que cada serviço define. A Prometiam é a terceira via: uma API paga, com chave, preço público e o mesmo formato de resposta para os 27 países que cobre, de modo que o código que valida um fornecedor em São Paulo valida também um fornecedor em Madri.
Você envia o CNPJ, com ou sem pontuação, ou apenas os oito dígitos da raiz, e recebe o registro da matriz. Os dados vêm dos arquivos de dados abertos da Receita Federal, que publica um arquivo completo por mês: a atualização é mensal, não uma consulta ao vivo. O formato alfanumérico do CNPJ, em vigor desde julho de 2026, também é aceito: veja o guia do CNPJ alfanumérico.
A busca por CNPJ é uma única chamada GET. Os exemplos usam o CNPJ da Petrobras, 33.000.167/0001-01; a resposta traz uma lista em data.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=BR&company_number=33.000.167/0001-01' \ -H 'Authorization: Bearer rk_live_...'
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'BR', 'company_number': '33.000.167/0001-01'})
empresa = r.json()['data'][0]
print(empresa['company_name'], empresa['status'], empresa['local_status'])
Não sabe o CNPJ? Busque por nome com name=, em vez de company_number=. Se você só quer testar um número, use o validador de CNPJ, sem cadastro.
| Campo | O que significa |
|---|---|
company_number | CNPJ da matriz com 14 caracteres; a raiz de 8 dígitos também encontra o registro |
company_name | Razão social como consta na Receita |
registry_details.trade_name | Nome fantasia |
status e local_status | Situação padronizada (ativa, suspensa, inapta, baixada) e o texto da Receita |
legal_form e local_legal_form | Natureza jurídica: Ltda., S.A., sociedade simples, EIRELI, cooperativa, empresa pública |
activity_code | Código CNAE 2.3 da atividade principal, com o esquema BR-CNAE-2.3 |
endereço e registry_details | Logradouro, município, estado e CEP, mais a data de abertura e a situação especial |
Para o Brasil existem eventos de alteração do registro (razão social, situação, natureza jurídica e endereço da sede). Cada evento recebe a data em que a mudança aparece pela primeira vez nos dados do registro, e não há eventos anteriores à primeira carga, em outubro de 2026. Com POST /monitor você recebe um webhook quando a situação muda, quando a empresa é baixada, quando há um acerto em listas de sanções (em beta) e quando surge um evento do registro.
vat= é recusada.status.BR-CNAE-2.3), não a NACE, e nenhum código NACE é derivado dela.O teste gratuito dura 14 dias e inclui 500 créditos; é preciso informar um cartão, mas nada é cobrado durante o teste. Depois, o plano Starter custa € 9,99 por mês com 1.000 créditos, o Professional € 29,99 com 10.000 e o Scale € 99,99 com 50.000; o Enterprise tem preço sob consulta. Consultar um registro de empresa custa 1 crédito, cerca de € 0,01 no Starter e a partir de € 0,002 no Scale. Os preços são públicos e o plano anual dá dois meses grátis.
Contains data from the Cadastro Nacional da Pessoa Jurídica (CNPJ), Receita Federal do Brasil, published as open data (CC BY). Adapted by Prometiam.
Começar o teste gratuito de 14 dias · Documentação da API
O teste dura 14 dias e inclui 500 créditos. É necessário informar um cartão; nada é cobrado durante o teste e, depois, vale o plano Starter (€ 9,99 por mês), salvo cancelamento.