Riferimento degli errori
Il corpo di ogni errore contiene un code, un message in linguaggio semplice, il request_id e un elenco remedies. Il campo docs rimanda alla voce del codice in questa pagina.
invalid_request (400)
Un parametro manca o ha un formato errato. Il messaggio indica il parametro. Correggi la richiesta e inviala di nuovo.
unauthorized (401)
La richiesta conteneva una chiave API con un formato errato, revocata o priva dell'ambito di autorizzazione richiesto dal percorso. Ogni percorso dati funziona anche senza chiave: rimuovi l'intestazione Authorization per usare i limiti previsti senza chiave. Le chiavi non sono ancora rilasciate al pubblico. Vedi Chiavi API.
payment_required (402)
Solo l'host agent.financial.md restituisce questo errore. Su questo host, un percorso a pagamento richiede un pagamento: l'intestazione PAYMENT-REQUIRED contiene il prezzo e le condizioni. Paga con x402 e invia di nuovo la chiamata, oppure chiama lo stesso percorso su api.financial.md senza chiave, entro i limiti giornalieri. Vedi Prezzi.
unknown_company (404)
Nessuna società corrisponde al parametro company. Prova il CIK (cik:320193) oppure cerca con GET /v1/companies?q=. Una società non più quotata non può essere cercata tramite ticker: usa il suo CIK. GET /v1/companies?status=delisted elenca queste società.
unknown_concept (404)
L'identificativo della voce o dell'indice non è presente nel modello della società. GET /v1/company/metrics elenca gli identificativi.
not_found (404)
Il percorso, il documento depositato presso la SEC o l'identificativo della prova non esiste. Controlla il numero di registrazione o l'identificativo della prova.
not_covered (404)
La società è nota, ma questo insieme di dati non è disponibile per essa. Il corpo elenca available_datasets. Una società che redige i bilanci secondo IFRS dispone di documenti depositati presso la SEC, ma non ancora di prospetti standardizzati.
rate_limited (429)
Il limite giornaliero per questa classe di percorsi è esaurito. Attendi il numero di secondi indicato in Retry-After. I limiti sono riportati nella pagina della documentazione. Le chiavi con limiti più elevati non sono ancora rilasciate.
upstream_unavailable (503)
L'API non è riuscita a raggiungere il proprio database. Riprova dopo una breve attesa. Il request_id ci aiuta a trovare la chiamata.