Referência

Erros

Códigos de status e formato das respostas de erro.

StatusQuando
400CNPJ com formato ou dígitos verificadores inválidos; na busca, limit ou cursor inválidos.
404CNPJ válido, mas inexistente na base.
429Busca paginada: limite do servidor atingido.
502Nenhum provedor respondeu. O corpo traz o erro de cada um.

Formato

// v2
{ "error": "CNPJ inválido: informe 12 caracteres alfanuméricos + 2 dígitos verificadores." }

// v1
{ "detail": "CNPJ inválido: informe 12 caracteres alfanuméricos + 2 dígitos verificadores." }

Erro 502

{
  "message": "Falha ao consultar CNPJ em ambas as fontes.",
  "minhareceita_error": "HTTP 500 ao consultar minhareceita.org",
  "receitaws_error": "HTTP 429 ao consultar receitaws.com.br"
}