SonarPJ

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=receitaws

Limites e cota

  • Rate limit por chave (req/min do plano). Excedeu → 429 com header Retry-After.
  • Cota mensal por conta (hard limit). Esgotou → 429 com código quota_exceeded até a renovação ou upgrade.
  • Conta como consumo cada resposta 200 de 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.