API CNPJ
Consulte dados completos de qualquer CNPJ — empresa, estabelecimento, endereço, CNAE e quadro societário — em uma única chamada de API. Cadastro grátis, chave em segundos.
- ✓Dados agregados
- Empresa (razão social, natureza jurídica, capital, porte), estabelecimento (endereço, situação cadastral, CNAE) e sócios — tudo em um único JSON.
- ✓Base atualizada
- Dados extraídos diretamente dos arquivos abertos da Receita Federal, atualizados mensalmente.
- ✓Simples de integrar
- Um único endpoint REST, autenticado por token. Sem SDKs obrigatórios, sem complicação.
- ✓Cadastro grátis
- 10 consultas por hora sem custo, sem cartão de crédito. Planos com mais volume em breve.
Como funciona
1. Autenticação
Toda chamada precisa do header Authorization com sua chave de API, no formato Bearer iv-live-.... Você recebe a chave uma única vez no cadastro — guarde-a com cuidado, ela não pode ser recuperada depois.
2. Fazendo uma consulta
GET /api/v1/cnpj/{cnpj}, onde {cnpj} são os 14 dígitos, sem pontuação.
curl https://infoville.com.br/api/v1/cnpj/02662686000101 \
-H "Authorization: Bearer iv-live-SEU_TOKEN_AQUI"3. Resposta
Exemplo de retorno (campos podem vir nulos quando a Receita não informa o dado):
{
"cnpj": 2662686000101,
"razao_social": "TUDO FACIL LAVANDERIA E TINTURARIA LTDA",
"nome_fantasia": "TUDO FACIL",
"natureza_juridica": 2062,
"porte": "DEMAIS",
"capital_social": 0,
"matriz_filial": "MATRIZ",
"situacao_cadastral": "ATIVA",
"data_situacao_cadastral": "2015-02-09",
"data_inicio": "1998-07-22",
"endereco": {
"tipo_logradouro": "RUA",
"logradouro": "RUA CARDOSO DE ALMEIDA",
"numero": "1479",
"complemento": "LOJA 1",
"bairro": "BARRA FUNDA",
"cep": "05013001",
"municipio": "SAO PAULO",
"uf": "SP"
},
"contato": {
"email": "[email protected]",
"telefone1": "1122223333",
"celular1": "11988887777"
},
"cnae_principal": {
"codigo": 9601701,
"descricao": "LAVANDERIAS"
},
"cnae_secundarios": [],
"socios": [
{
"nome": "FULANO DE TAL",
"tipo": "PESSOA FISICA",
"qualificacao": "49",
"data_entrada": "1998-07-22",
"faixa_etaria": 6
}
]
}4. Headers de resposta
Toda consulta (mesmo as que retornam erro) inclui headers com a situação atual dos seus créditos — não é preciso consultar o painel pra saber quanto ainda tem disponível:
| Header | Significado |
|---|---|
| X-Credits-Limit | Créditos totais que sua chave recebe a cada renovação (hora). |
| X-Credits-Remaining | Créditos restantes após esta consulta. |
| X-Credits-Consumed | Créditos consumidos nesta consulta (0 quando o limite já estava esgotado). |
| X-RateLimit-Reset | Data/hora (ISO 8601) em que o saldo renova. |
5. Limites do plano grátis
O plano grátis dá direito a 10 consultas por hora. O saldo é renovado a cada hora — ele não acumula de uma hora pra outra. Ao esgotar o saldo, a API responde com 429 (acompanhado dos headers acima) até a próxima renovação.
1 crédito equivale a 1 consulta — e só é descontado quando o CNPJ é encontrado. Uma consulta que retorna 404 (CNPJ não encontrado) não consome crédito da sua chave.