Documentação da API

A API LocalizaCNPJ fornece acesso programático aos dados públicos de CNPJ da Receita Federal do Brasil. Consulte informações de empresas, estabelecimentos, sócios e atividades econômicas.

BASE URL

https://api.LocalizaCNPJ.com.br

key Autenticação

Todas as requisições devem incluir sua API key no header Authorization.

Authorization: Bearer SUA_API_KEY
info

Dica: teste direto aqui

Cole sua API key no campo no topo da página e use os botões "Testar" em cada endpoint para fazer requisições reais à API.

error Códigos de Erro

CÓDIGO DESCRIÇÃO
200 Sucesso
401 Não autorizado — API key ausente ou inválida
404 CNPJ não encontrado na base da Receita Federal
422 CNPJ inválido (formato ou dígitos verificadores incorretos)
429 Limite de requisições excedido
500 Erro interno do servidor

speed Limites de Uso

PLANO CONSULTAS/MÊS REQ/MIN VALOR
Free 2.000 40 Grátis
Starter 30.000 120 R$ 29/mês
Pro 100.000 500 R$ 69/mês
Premium 300.000 1.000 R$ 179/mês
Business 900.000 2.000 R$ 379/mês
Enterprise Volume sob consulta 4.000+ A partir de R$ 879/mês

Consultar CNPJ

Retorna dados completos de uma empresa: razão social, estabelecimentos, sócios, CNAEs e endereço.

GET /cnpj/{numero}?limit={n}&offset={n}

link Parâmetros

NOME TIPO DESCRIÇÃO
numero * string CNPJ com ou sem pontuação
limit int Limite de filiais/sócios (default: 100, max: 1000)
offset int Offset para paginação (default: 0)

code Exemplo de Resposta

{
  "cnpj_basico": "00000000",
  "razao_social": "EMPRESA FICTICIA LTDA",
  "natureza_juridica": "206-2",
  "capital_social": 100000.0,
  "porte_empresa": "01",
  "ente_federativo_responsavel": null,
  "estabelecimentos": [
    {
      "cnpj_ordem": "0001",
      "cnpj_dv": "91",
      "nome_fantasia": "MATRIZ FICTICIA",
      "situacao_cadastral": "02",
      "data_situacao_cadastral": "20200101",
      "data_inicio_atividade": "20200101",
      "cnae_principal": "6204000",
      "tipo_logradouro": "RUA",
      "logradouro": "FICTICIA",
      "numero": "123",
      "complemento": "SALA 1",
      "bairro": "CENTRO",
      "cep": "00000000",
      "uf": "SP",
      "municipio": "SAO PAULO"
    }
  ],
  "socios": [],
  "simples": null
}
Testar Endpoint

Buscar por Razão Social

Busca empresas pelo início da razão social. Retorna dados básicos da empresa incluindo CNPJ base, natureza jurídica e porte.

GET /busca/razao-social?q={termo}

link Parâmetros

NOME TIPO DESCRIÇÃO
q * string Termo de busca (mín. 2 caracteres)
limit int Máximo de resultados (default: 20, max: 100)
offset int Offset para paginação (default: 0)

code Exemplo de Resposta

{
  "query": "EMPRESA",
  "total": 1,
  "limit": 20,
  "offset": 0,
  "resultados": [
    {
      "cnpj_basico": "00000000",
      "cnpj_completo": "00000000000191",
      "razao_social": "EMPRESA FICTICIA LTDA",
      "natureza_juridica": "2062",
      "capital_social": "100000.00",
      "porte_empresa": "01"
    }
  ]
}
Testar Endpoint

Buscar por Nome Fantasia

Busca estabelecimentos pelo início do nome fantasia. Retorna CNPJ completo, razão social, situação cadastral, UF e município.

GET /busca/nome-fantasia?q={termo}

link Parâmetros

NOME TIPO DESCRIÇÃO
q * string Termo de busca (mín. 2 caracteres)
limit int Máximo de resultados (default: 20, max: 100)
offset int Offset para paginação (default: 0)

code Exemplo de Resposta

{
  "query": "LOJA",
  "total": 1,
  "limit": 20,
  "offset": 0,
  "resultados": [
    {
      "cnpj_basico": "00000000",
      "cnpj_ordem": "0001",
      "cnpj_dv": "91",
      "cnpj_completo": "00000000000191",
      "nome_fantasia": "LOJA FICTICIA",
      "razao_social": "EMPRESA FICTICIA LTDA",
      "situacao_cadastral": "02",
      "uf": "SP",
      "municipio": "SAO PAULO"
    }
  ]
}
Testar Endpoint

Buscar por Nome do Sócio

Busca sócios pelo início do nome. Retorna o nome do sócio, razão social da empresa associada, qualificação e data de entrada.

GET /busca/socio?q={termo}

link Parâmetros

NOME TIPO DESCRIÇÃO
q * string Termo de busca (mín. 2 caracteres)
limit int Máximo de resultados (default: 20, max: 100)
offset int Offset para paginação (default: 0)

code Exemplo de Resposta

{
  "query": "FULANO",
  "total": 1,
  "limit": 20,
  "offset": 0,
  "resultados": [
    {
      "cnpj_basico": "00000000",
      "cnpj_completo": "00000000000191",
      "nome_socio": "FULANO DE TAL",
      "razao_social": "EMPRESA FICTICIA LTDA",
      "qualificacao_socio": "49",
      "data_entrada_sociedade": "20200101"
    }
  ]
}
Testar Endpoint

Meus Dados

Retorna os dados da conta associada à API key utilizada na requisição.

GET /auth/me

Nenhum parâmetro necessário. A identificação é feita pela API key no header.

code Exemplo de Resposta

{
  "id": "e2f5b6a7-...",
  "name": "Meu App",
  "plan": "free",
  "created_at": "2026-08-15T12:00:00"
}
Testar Endpoint

Meu Consumo

Retorna o consumo atual da conta: consultas no mês, limite do plano e taxa por minuto.

GET /auth/usage

Nenhum parâmetro necessário.

code Exemplo de Resposta

{
  "current_month_requests": 145,
  "plan_limit": 5000,
  "rate_limit_per_minute": 30
}
Testar Endpoint

Histórico de Consumo

Retorna o histórico detalhado de todas as requisições feitas pela API key.

GET /auth/usage/history?limit={n}&offset={n}

link Parâmetros

NOME TIPO DESCRIÇÃO
limit int Quantidade de registros (default: 100, max: 1000)
offset int Offset para paginação (default: 0)

code Exemplo de Resposta

{
  "total": 145,
  "limit": 100,
  "offset": 0,
  "history": [
    {
      "endpoint": "/cnpj/00000000000191",
      "timestamp": "2026-08-15T12:05:22",
      "status_code": 200,
      "ip_address": "192.168.0.1"
    }
  ]
}
Testar Endpoint

Health Check

Verifica se a API e o banco de dados estão operacionais. Não requer autenticação.

GET /health

Endpoint público — nenhuma autenticação necessária.

code Exemplo de Resposta

{
  "status": "ok",
  "timestamp": "2026-08-15T12:10:00",
  "db_ready": true,
  "db_size_bytes": 35432001536
}
Testar Endpoint