Referência de erros
Todo corpo de erro tem um code, uma message em linguagem simples, o request_id e uma lista remedies. O campo docs contém um link para a entrada do código nesta página.
invalid_request (400)
Um parâmetro está ausente ou malformado. A mensagem identifica o parâmetro. Corrija a requisição e envie-a novamente.
unauthorized (401)
A requisição trouxe uma chave de API malformada, revogada ou sem o escopo exigido pela rota. Todas as rotas de dados também funcionam sem chave: remova o cabeçalho Authorization para usar os limites sem chave. As chaves ainda não são emitidas publicamente. Veja Chaves de API.
payment_required (402)
Somente o host agent.financial.md retorna esta resposta. Uma rota paga nesse host exige um pagamento: o cabeçalho PAYMENT-REQUIRED contém o preço e os termos. Pague com x402 e envie a chamada novamente, ou chame a mesma rota em api.financial.md sem chave, dentro dos limites diários. Veja Preços.
unknown_company (404)
Nenhuma empresa correspondeu ao parâmetro company. Tente o CIK (cik:320193) ou pesquise com GET /v1/companies?q=. Uma empresa retirada da bolsa não pode ser consultada pelo ticker: use seu CIK. GET /v1/companies?status=delisted lista essas empresas.
unknown_concept (404)
O identificador do conceito ou indicador não está no modelo da empresa. GET /v1/company/metrics lista os identificadores.
not_found (404)
O caminho, o documento arquivado na SEC ou o identificador de prova não existe. Verifique o número de acesso ou o identificador de prova.
not_covered (404)
A empresa é conhecida, mas este conjunto de dados não está disponível para ela. O corpo lista available_datasets. Uma empresa que reporta segundo IFRS tem documentos arquivados na SEC, mas ainda não tem demonstrações padronizadas.
rate_limited (429)
O limite diário para esta classe de rota foi esgotado. Aguarde o número de segundos indicado em Retry-After. Os limites estão na página de documentação. Chaves com limites maiores ainda não são emitidas.
upstream_unavailable (503)
A API não conseguiu acessar seu banco de dados. Tente novamente após uma breve espera. O request_id nos ajuda a localizar a chamada.