Documentação

Sobre

A API CNPJ permite consultar dados oficiais da Receita Federal de forma completa e enriquecida: cadastrais, sócios (QSA), filiais, geolocalização, faixa de funcionários, faturamento estimado, inscrição estadual e dados ANTT — em milissegundos.

Todos os endpoints retornam JSON, exigem autenticação Bearer Token e suportam CORS.

Autenticação

Todas as requisições exigem o header Authorization usando o padrão Bearer Token.

Seu token é gerado automaticamente após a confirmação de pagamento do Plano. Ele fica disponível no seu Painel.

curl -X GET "https://api.apicnpjs.com.br/v1/cnpj/11222333000181" \
  -H "Authorization: Bearer SEU_TOKEN"

🚀 Início rápido

Para consultar um CNPJ, basta uma única requisição. CNPJ aceito com ou sem máscara:

GET https://api.apicnpjs.com.br/v1/cnpj/11222333000181

A resposta inclui dados cadastrais, sócios, filiais e informações extras em um único payload.

1. Consulta completa

Retorna dados cadastrais + sócios + filiais + dados extras + ANTT. Para omitir os sócios, use ?include_socios=false.

{
  "cnpj": "11222333000181",
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "nome_fantasia": "EXEMPLO",
  "situacao_cadastral": "ATIVA",
  "data_abertura": "2010-05-12",
  "porte": "DEMAIS",
  "natureza_juridica": "206-2",
  "endereco": { ... },
  "socios": [ ... ],
  "filiais": [ ... ],
  "extra": { ... }
}

2. Consulta básica

Apenas dados cadastrais — resposta mais rápida e leve. Ideal para validações em massa.

3. Busca avançada

Filtros por CNAE, UF, município, situação cadastral e porte. Paginação até 200 resultados por página.

{
  "uf": "SP",
  "municipio": "SAO PAULO",
  "cnae_principal": "6201501",
  "situacao": "ATIVA",
  "page": 1,
  "page_size": 50,
  "sort_by": "razao_social",
  "sort_dir": "asc"
}

4. Sócios (QSA)

Lista os sócios do CNPJ com qualificação e empresas vinculadas a cada sócio.

5. Filiais

Lista todas as filiais associadas ao CNPJ informado.

6. Mesmo proprietário

Outros CNPJs que possuem os mesmos sócios.

7. Empresas por sócio

Lista as empresas onde um CPF ou CNPJ figura como sócio.

✨ Dados extras

Geolocalização (latitude/longitude), faixa de funcionários, faturamento estimado e inscrição estadual.

Exemplos de uso

cURL

curl -X GET "https://api.apicnpjs.com.br/v1/cnpj/11222333000181" \
  -H "Authorization: Bearer SEU_TOKEN"

JavaScript

const res = await fetch("https://api.apicnpjs.com.br/v1/cnpj/11222333000181", {
  headers: { Authorization: "Bearer SEU_TOKEN" },
});
const data = await res.json();
console.log(data);

Python

import requests

r = requests.get(
    "https://api.apicnpjs.com.br/v1/cnpj/11222333000181",
    headers={"Authorization": "Bearer SEU_TOKEN"},
)
print(r.json())

PHP

<?php
$ch = curl_init("https://api.apicnpjs.com.br/v1/cnpj/11222333000181");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer SEU_TOKEN",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Códigos de retorno