Consultar um CNPJ

O endpoint principal da CNPJAPI recebe um CNPJ e devolve os dados cadastrais da empresa em JSON, com base nos dados públicos da Receita Federal.

Método e caminho: GET /{cnpj}
Base URL: https://api.cnpjapi.com.br
Parâmetro: apenas os 14 dígitos do CNPJ, sem pontuação (ex.: 00776574000156). Máscara com . e / não é aceita no caminho.
Autenticação: API key no cabeçalho Authorization (veja Autenticação).

Exemplo (curl)

curl https://api.cnpjapi.com.br/00776574000156 \
  -H "Authorization: Bearer cnpj_sua_chave"

Exemplos por linguagem

Prefere copiar e colar no seu stack? Os guias trazem o mesmo endpoint com autenticação e tratamento de 429/Retry-After prontos:

Quer testar sem escrever nada? Abra a coleção no Postman e rode as chamadas no navegador (é só informar sua chave).

Resposta (`200 OK`, `application/json`)

{
  "CNPJ": "00776574000156",
  "RazaoSocial": "...",
  "NomeFantasia": "...",
  "MatrizFilial": { "Codigo": "1", "Descricao": "Matriz" },
  "Porte": { "Codigo": "05", "Descricao": "Demais" },
  "DataAbertura": "0000-00-00",
  "AtividadePrincipal": { "Codigo": "0000000", "Descricao": "..." },
  "AtividadesSecundarias": [ { "Codigo": "0000000", "Descricao": "..." } ],
  "NaturezaJuridica": { "Codigo": "0000", "Descricao": "..." },
  "SituacaoCadastral": { "Codigo": "02", "Descricao": "ATIVA", "Motivo": "...", "Data": "0000-00-00" },
  "SimplesNacional": "...",
  "Endereco": {
    "TipoLogradouro": "...", "Logradouro": "...", "Numero": "...",
    "Complemento": "...", "Bairro": "...", "CEP": "...", "Municipio": "...", "UF": "..."
  },
  "Municipio": { "SIAFI": "...", "IBGE": "...", "Nome": "..." },
  "Contato": { "DDD1": "...", "Telefone1": "...", "Email": "...", "DDD2": "...", "Telefone2": "..." },
  "QSA": [
    { "Nome": "...", "Tipo": "...", "CPFCNPJ": "...", "Qualificacao": "...", "DataEntradaSociedade": "0000-00-00", "FaixaEtaria": "..." }
  ],
  "CapitalSocial": 0,
  "UltimaAtualizacao": "0000-00-00",
  "EFR": "..."
}

Campos da resposta

Campo	Descrição
`CNPJ`	CNPJ consultado (14 dígitos)
`RazaoSocial`	Razão social
`NomeFantasia`	Nome fantasia
`SituacaoCadastral`	Situação cadastral (`Codigo`, `Descricao`, `Motivo`, `Data`)
`AtividadePrincipal`	CNAE principal (`Codigo`, `Descricao`)
`AtividadesSecundarias`	Lista de CNAEs secundários
`NaturezaJuridica`	Natureza jurídica (`Codigo`, `Descricao`)
`Endereco`	Logradouro, número, complemento, bairro, CEP, município, UF
`Municipio`	Município (`SIAFI`, `IBGE`, `Nome`)
`Contato`	Telefones e e-mail, quando disponíveis
`QSA`	Quadro societário: sócios (`Nome`, `Tipo`, `CPFCNPJ`, `Qualificacao`, ...)
`CapitalSocial`	Capital social
`Porte` / `MatrizFilial` / `SimplesNacional`	Metadados cadastrais

Consultar muitos CNPJs

Tem um plano pago? Consulte até 20 CNPJs numa só chamada com POST /consulta/lote - conta como 1 requisição pro rate limit. Sem plano pago, ou para consultas avulsas, chame GET /{cnpj} uma vez por CNPJ, respeitando os limites do seu plano (requisições por minuto e cota mensal). Ao exceder, a API responde 429 com Retry-After - use esse valor para pausar antes de continuar.

Inscrição Estadual junto (opcional)

Precisa da Inscrição Estadual junto com os dados cadastrais? Acrescente ?incluir=ie: a resposta ganha o campo inscricoes_estaduais (lista por UF, na fonte oficial da SEFAZ). É um recurso premium: exige conta registrada (uma chamada anônima com ?incluir=ie recebe 401), consome cota/crédito de IE e vale só no formato nativo.

curl "https://api.cnpjapi.com.br/00776574000156?incluir=ie" \
  -H "Authorization: Bearer cnpj_sua_chave"

Campo	Descrição
`inscricoes_estaduais`	Lista de inscrições por UF (`uf`, `ie`, `indicador`, `situacao`, `tipo`, ...). Use `?ie_uf=SP` para mirar uma UF (1 crédito); sem ela, varredura nacional (3 créditos)
`inscricoes_estaduais_erro`	Presente só quando a IE falhou: `inscricoes_estaduais` vem `null` e este campo traz o motivo (ex.: `indisponivel`). Nesse caso a IE não é cobrada

Contrato completo, campos e créditos em Consultar a Inscrição Estadual.

Formato ReceitaWS

Já integra a ReceitaWS? A CNPJAPI também responde no formato dela, campo a campo - basta usar GET /v1/cnpj/{cnpj} ou GET /{cnpj}?formato=receitaws. Veja Compatível com a ReceitaWS.

Próximos passos

Autenticação - gere sua API key.
Consultar CNPJs em lote - até 20 numa só chamada (plano pago).
Consultar a Inscrição Estadual - a IE por CNPJ, na fonte oficial.
Compatível com a ReceitaWS - migre trocando só o host.
Limites e planos - quantas consultas seu plano permite.
Consultar a cota - acompanhe o consumo do mês.
Erros - o que cada código de status significa.

Crie sua conta gratuita em https://app.cnpjapi.com.br e faça a primeira consulta em minutos.