Status e code
200 traz o documento. Erros vêm como {status:"ERROR", message, code}: invalid_cnpj (400), not_found (404), rate_limited ou quota_exceeded (429).
Monte a requisição, envie e veja a resposta real. A consulta de CNPJ exige conta grátis: logado, o sandbox usa a sua sessão e conta na cota do seu plano. Validação e status são abertos.
Requisição
{ "cnpj": "11378117000120", "cnpj_formatado": "11.378.117/0001-20", "razao_social": "LEADS2B S/A", "nome_fantasia": "LEADS2B.COM", "matriz_filial": "MATRIZ", "situacao_cadastral": { "codigo": "02", "descricao": "ATIVA", "data": "2009-11-24", "motivo": { "codigo": "00", "descricao": "SEM MOTIVO" } }, "situacao_especial": { "descricao": null, "data": null }, "data_inicio_atividade": "2009-11-24", "natureza_juridica": { "codigo": "2054", "descricao": "Sociedade Anônima Fechada" }, "porte": { "codigo": "05", "descricao": "DEMAIS" }, "capital_social": 218878, "cnae_principal": { "codigo": "6311900", "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet" }, "cnaes_secundarios": [ { "codigo": "8599604", "descricao": "Treinamento em desenvolvimento profissional e gerencial" } ], "endereco": { "tipo_logradouro": "RUA", "logradouro": "PADRE ANCHIETA", "numero": "2285", "complemento": "CONJ 1603 ANDAR 16 COND BUSINESS CENTER", "bairro": "BIGORRILHO", "cep": "80730001", "municipio": { "codigo_ibge": "4106902", "nome": "CURITIBA" }, "uf": "PR", "pais": null }, "telefones": [ { "ddd": "41", "numero": "30287828" } ], "fax": null, "email": "contabilidade@leads2b.com", "ente_federativo_responsavel": null, "simples": { "optante": false, "data_opcao": "2009-11-24", "data_exclusao": "2019-12-31" }, "mei": { "optante": false, "data_opcao": null, "data_exclusao": null }, "socios": [ { "nome": "FULANO DE TAL", "tipo": "PESSOA FISICA", "cpf_cnpj": "***123456**", "qualificacao": { "codigo": "10", "descricao": "Diretor" }, "data_entrada": "2009-11-24", "faixa_etaria": "41 a 50 anos", "pais": null, "representante_legal": null } ], "atualizado_em": "2026-09" }
| Nome | Valor | Significado |
|---|---|---|
| Envie uma requisição para ver os cabeçalhos. | ||
code200 traz o documento. Erros vêm como {status:"ERROR", message, code}: invalid_cnpj (400), not_found (404), rate_limited ou quota_exceeded (429).
X-RateLimit-* conta o minuto; X-Quota-* conta o mês da sua conta. Em 429, Retry-After diz quanto esperar.
?formato=simplificado devolve um formato plano com campos já formatados: datas DD/MM/AAAA, CNPJ e CEP com pontuação, qsa e atividade_principal em listas simples.
Letras nas 12 primeiras posições, DV numérico pelo módulo 11 com ASCII − 48. Teste com o exemplo “alfanumérico” acima.
Algoritmo →