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}

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)
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.

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.

Testar Endpoint

Histórico de Consumo

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

GET /auth/usage/history

link Parâmetros

NOME TIPO DESCRIÇÃO
limit int Quantidade de registros (default: 100, max: 1000)
offset int Offset para paginação (default: 0)
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.

Testar Endpoint