API para consulta CNPJ, lotes e produtos comerciais
Consulte empresas brasileiras, processe bases em fila, gere mailings segmentados e exporte dados enriquecidos em Excel ou PDF.
No Swagger abaixo você pode informar seu token e executar chamadas reais, ou usar dados mockados para testar o contrato das respostas sem consumir saldo.
Autenticação
Use o token gerado na área do cliente. Todas as chamadas protegidas usam Bearer Token.
Bearer SEU_TOKEN
Rate limits e consumo
Cada plano define limites mensais por produto e limite de requisições por segundo. Ao ultrapassar o limite, a API retorna HTTP 429.
Swagger / testar produtos
Escolha o produto, informe seu token para chamada real ou marque a opção de usar dados mockados. Os campos obrigatórios mudam conforme o produto e método selecionado.
/api/v1/cnpj/{cnpj}
Recupera as informações cadastrais de uma empresa pelo CNPJ.
Path parameters
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
cnpj | string | Sim | CNPJ sem máscara, com 14 dígitos. |
Exemplo cURL
curl --request GET \
--url https://cnpj.w3developer.com.br/api/v1/cnpj/37120124000110 \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN'/api/v1/cnpj/{cnpj}/export
Exporta a consulta individual em PDF ou Excel com layout formatado.
| Campo | Tipo | Descrição |
|---|---|---|
format | string | pdf ou xlsx. |
/api/v1/cnpj/lote
Cria uma consulta em lote. Retorna um job e processa pela fila.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
cnpjs | array[string] | Sim | Lista de CNPJs sem máscara. |
webhook_url | string | Não | URL para notificação ao finalizar. |
/api/v1/cnpj/lote/{job}
Consulta status, progresso e link de download de um job em lote.
/api/v1/mailing
Gera mailing segmentado com filtros comerciais. Produto processado em fila.
/api/v1/higienizacao
Recebe arquivo CSV/XLSX com CNPJs e devolve planilha enriquecida. Produto processado em fila.
Exemplo de retorno
{
"status": "OK",
"ultima_atualizacao": "2026-06-25T23:59:00-03:00",
"cnpj": "37120124000110",
"tipo": "MATRIZ",
"porte": "MICRO EMPRESA",
"nome": "EMPRESA DEMONSTRAÇÃO LTDA",
"fantasia": "DEMONSTRAÇÃO API CNPJ",
"abertura": "01/05/2020",
"atividade_principal": [
{"code": "6201501", "text": "Desenvolvimento de programas de computador sob encomenda"}
],
"atividades_secundarias": [
{"code": "6311900", "text": "Tratamento de dados e hospedagem"}
],
"natureza_juridica": "2062 - SOCIEDADE EMPRESÁRIA LIMITADA",
"logradouro": "AVENIDA BRASIL",
"numero": "1000",
"complemento": "SALA 10",
"cep": "80000000",
"bairro": "CENTRO",
"municipio": "CURITIBA",
"uf": "PR",
"email": "contato@empresa.com.br",
"telefone": "41999999999",
"situacao": "ATIVA",
"capital_social": "R$ 100.000,00",
"qsa": [{"nome": "SÓCIO DEMONSTRAÇÃO", "qual": "Sócio-Administrador"}],
"billing": {"free": false, "database": true}
}Objeto CNPJ
| Campo | Tipo | Descrição |
|---|---|---|
status | string | OK ou ERROR. |
ultima_atualizacao | datetime | Data da última atualização disponível. |
cnpj | string | CNPJ consultado. |
tipo | string | MATRIZ ou FILIAL. |
porte | string | Porte traduzido. |
nome | string | Razão social. |
atividade_principal | array | CNAE principal com código e descrição. |
atividades_secundarias | array | CNAEs secundários. |
qsa | array | Quadro societário. |
simples | object | Opção Simples Nacional. |
simei | object | Opção MEI. |
billing | object | Dados de consumo. |
Erros
| Código | Quando ocorre |
|---|---|
401 | Token ausente ou inválido. |
403 | Cliente bloqueado, token inativo ou plano indisponível. |
404 | CNPJ ou job não encontrado. |
422 | Parâmetros inválidos. |
429 | Limite de consumo ou rate limit excedido. |
504 | Processamento em tempo limite. |
Webhooks
Para lotes, a plataforma pode notificar uma URL quando o processamento finalizar.
{
"event": "batch.finished",
"job_id": "job_123",
"status": "finished",
"download_url": "https://.../arquivo.xlsx"
}