Documentação da API
API REST para consulta de CNPJ. Base: https://api.sonarpj.com.br. Versão por caminho (/v1).
Autenticação
Toda chamada exige uma API key da sua conta, no header Authorization ou X-API-Key. Chaves de produção começam com sk_live_; sandbox com sk_test_.
curl https://api.sonarpj.com.br/v1/cnpj/11222333000181 \
-H "Authorization: Bearer sk_live_sua_chave"Consultar um CNPJ
GET /v1/cnpj/{cnpj} — informe os 14 dígitos. Os campos retornados variam conforme o plano (Free omite QSA, Simples e contato completo).
Migrando de outra API de CNPJ? No plano Pro+, o parâmetro ?format=receitaws devolve o dossiê no formato compatível com o padrão ReceitaWS. Assim, quem já consome esse formato aponta a integração para o SonarPJ com pouco ou nenhum esforço — sem reescrever o parser.
GET /v1/cnpj/11222333000181?format=receitawsLimites e cota
- Rate limit por chave (req/min do plano). Excedeu →
429com headerRetry-After. - Cota mensal por conta (hard limit). Esgotou →
429com códigoquota_exceededaté a renovação ou upgrade. - Conta como consumo cada resposta
200de produção (inclusive servida do cache). Sandbox não consome cota. - Headers de resposta:
X-Quota-Limit,X-Quota-Remaining,X-Cache.
Erros
Erros seguem o padrão application/problem+json (RFC 7807), com um code estável para tratamento.
{
"type": "https://sonarpj.com.br/errors/quota_exceeded",
"title": "quota_exceeded",
"status": 429,
"detail": "Cota mensal esgotada.",
"code": "quota_exceeded"
}Quer testar sem integrar? Use o Playground ou gere uma chave sk_test_ no painel.