Consultar uma empresa
curl https://radardocnpj.com.br/api/v1/empresa/33000167000101 \ -H "Authorization: Bearer SUA_CHAVE"
A resposta:
{
"cnpj": "33000167000101",
"cnpj_formatado": "33.000.167/0001-01",
"razao_social": "PETROLEO BRASILEIRO S A PETROBRAS",
"nome_fantasia": "PETROBRAS - EDISE",
"situacao": "ativa",
"situacao_desde": "03/11/2005",
"abertura": "28/09/1966",
"natureza_juridica": "Sociedade de Economia Mista",
"porte": "demais",
"capital_social": 205431960490.52,
"regime_tributario": { "regime": "Não optante do Simples" },
"atividade_principal": { "codigo": "0600001", "descricao": "..." },
"endereco": { "logradouro": "...", "municipio": "RIO DE JANEIRO", "uf": "RJ" },
"socios": [ { "nome": "...", "qualificacao": "..." } ],
"_meta": { "custo_centavos": 2, "saldo_centavos": 9800 }
}
CNPJ não encontrado devolve 404 e
não é cobrado.
Conferir o saldo
curl https://radardocnpj.com.br/api/v1/saldo \ -H "Authorization: Bearer SUA_CHAVE"
Esta chamada é gratuita.
Erros
| Código | Quando acontece |
|---|---|
| 401 | Chave ausente, inválida ou revogada |
| 402 | Crédito insuficiente — recarregue em /creditos |
| 404 | CNPJ não existe na base (não cobra) |
| 429 | Mais de 120 consultas no mesmo minuto |
Todo erro volta como JSON {"erro": "..."} —
nunca como página HTML.