Digite o CNPJ, a raiz de 8 dígitos ou a razão social e veja o registro da empresa no cadastro da Receita Federal: razão social, nome fantasia, situação cadastral com a data, endereço com CEP, capital social, porte e as atividades em CNAE. Sem cadastro. MEI e empresário individual não aparecem; o motivo está mais abaixo.
CNPJ, raiz de 8 dígitos ou razão social
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=47960950000121&country=BR" \ -H "Authorization: Bearer YOUR_API_KEY"
Precisa do documento oficial? O Comprovante de Inscrição e de Situação Cadastral, o “cartão CNPJ”, é emitido de graça no site da Receita Federal, com uma verificação anti-robô. Esta página não emite o comprovante. Ela mostra numa tela só os dados cadastrais da empresa, como constam nos arquivos que a Receita publica todo mês, e a mesma consulta por API para quem precisa repeti-la em código.
Cada linha do resultado corresponde a um campo do cadastro. A tabela diz onde está cada informação do cartão CNPJ na consulta e qual é o nome do campo na API.
| No cartão CNPJ | Na consulta | Na API |
|---|---|---|
| Número de inscrição | CNPJ (o da matriz) | company_number |
| Data de abertura | Abertura | founding_date |
| Nome empresarial | Razão social, no título do resultado | company_name |
| Título do estabelecimento (nome de fantasia) | Nome fantasia | registry_details.trade_name |
| Porte | Porte: ME, EPP ou demais | registry_details.size_class |
| Código e descrição da natureza jurídica | Natureza jurídica | local_legal_form, local_legal_form_name |
| Atividade econômica principal | Atividade principal (CNAE) | activity_code, activity_description |
| Atividades econômicas secundárias | Atividades secundárias | secondary_activity_codes |
| Logradouro, número, bairro, CEP, município e UF | Endereço | address, registry_details.district, postal_code, city, region |
| Situação cadastral, data e motivo | A situação, no alto à direita, e “Situação desde” | status, status_date, registry_details.status_reason |
| Situação especial | Situação especial, quando houver | registry_details.special_situation |
| Endereço eletrônico e telefone | não exibidos | — |
O capital social não está no cartão, mas está no cadastro, e a consulta o mostra em reais; a API traz também o valor em euros, em capital_eur. Um capital informado como zero não é exibido. A data de abertura é a data de início da atividade registrada pela Receita: em empresas antigas ela é anterior ao próprio CNPJ, que substituiu o antigo CGC em 1998.
A situação cadastral é o primeiro dado a olhar. Ela diz se a inscrição está regular, não se a empresa tem dívidas: débitos tributários e pendências estaduais ou municipais ficam fora dela, e a certidão de débitos é outro documento.
| Situação na Receita | O que significa | Na API (status) |
|---|---|---|
| Ativa | A inscrição está regular no cadastro. | active |
| Suspensa | A Receita suspendeu a inscrição, em geral por uma inconsistência cadastral que a empresa precisa corrigir. | suspended |
| Inapta | A empresa deixou de cumprir obrigações com a Receita, como a entrega de declarações, ou não foi localizada no endereço do cadastro. A inscrição continua existindo e pode ser regularizada ou acabar baixada de ofício. | active_strike_off_pending |
| Baixada | A inscrição foi encerrada: a empresa foi extinta, incorporada, fundida ou totalmente cindida, ou a Receita fez a baixa de ofício. | deregistered; merged quando o motivo é incorporação, fusão ou cisão total |
| Nula | A inscrição foi anulada, por exemplo por ter sido feita em duplicidade. | não aparece na consulta |
Uma empresa ativa, suspensa ou inapta pode ter também uma situação especial: recuperação judicial, falência, liquidação judicial ou extrajudicial, ou intervenção. Nesse caso a consulta mostra o texto da Receita na linha “Situação especial”, e o status da API passa a ser a situação especial: in_restructuring (recuperação judicial), in_liquidation_insolvent (falência), in_compulsory_liquidation (liquidação judicial), in_liquidation (liquidação extrajudicial) ou in_administration (intervenção). O motivo da situação aparece ao lado da data, a não ser que a Receita registre “sem motivo”.
O CNPJ tem 14 caracteres. Os 8 primeiros são a raiz, que identifica a empresa; os 4 seguintes são a ordem, que identifica o estabelecimento (a matriz é quase sempre 0001, as filiais 0002, 0003 e assim por diante); os 2 últimos são os dígitos verificadores. A consulta serve um registro por empresa, o da matriz.
Digitou o CNPJ de uma filial, como o de uma nota fiscal emitida por ela? A ferramenta procura pela raiz e mostra a matriz, com um aviso acima do resultado; o CNPJ e o endereço exibidos são então os da matriz, não os da filial. Também dá para digitar só a raiz, com 8 dígitos.
Desde julho de 2026, novas inscrições podem ter letras na raiz e na ordem, no CNPJ alfanumérico; os dígitos verificadores continuam numéricos. Para conferir só os dígitos de um número, use o validador de CNPJ.
O microempreendedor individual (MEI) e o empresário individual têm CNPJ, mas são pessoas físicas, e o nome empresarial deles costuma trazer o nome e o CPF do titular. A Prometiam serve só pessoas jurídicas e deixa essas inscrições de fora, assim como as associações, as fundações e as demais entidades sem fins lucrativos, os órgãos públicos e as sucursais de empresas estrangeiras. Para um MEI, emita o comprovante na Receita ou o Certificado da Condição de Microempreendedor Individual (CCMEI) no Portal do Empreendedor.
A Receita publica um arquivo completo do cadastro por mês, e a consulta mostra o que está no último arquivo lido. Uma empresa que mudou de situação nas últimas semanas pode aparecer ainda com a situação anterior. Antes de uma decisão que não pode esperar, como pagar uma nota alta ou liberar crédito, emita o comprovante na Receita no mesmo dia.
Com uma chave, a consulta é uma chamada a GET /companies/search com country=BR e o CNPJ, com ou sem pontuação, ou a raiz de 8 dígitos. Ela custa 1 crédito, e erros não custam nada. A resposta traz o registro em JSON, com os campos da tabela acima.
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'])
Para acompanhar a empresa depois da consulta, POST /monitor gera um alerta quando a situação cadastral muda, quando a inscrição é baixada e quando o nome, a natureza jurídica, o endereço ou o capital social mudam. Esses eventos são datados quando a mudança aparece nos dados da Receita, e não há eventos anteriores a outubro de 2026. O teste monitora 3 empresas e o Starter 25, com os alertas lidos em GET /monitor; o envio por webhook vem a partir do Professional.
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.
vat= é recusada.status.BR-CNAE-2.3), não a NACE, e nenhum código NACE é derivado dela.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.