Referencia de errores
Cada cuerpo de error contiene un code, un message en lenguaje sencillo, el request_id y una lista remedies. El campo docs enlaza a la entrada del código en esta página.
invalid_request (400)
Falta un parámetro o su formato es incorrecto. El mensaje indica el parámetro. Corrige la solicitud y vuelve a enviarla.
unauthorized (401)
La solicitud incluía una clave de API con un formato incorrecto, revocada o sin el ámbito que requiere la ruta. Todas las rutas de datos también funcionan sin clave: elimina la cabecera Authorization para usar los límites sin clave. Aún no se emiten claves públicamente. Consulta Claves de API.
payment_required (402)
Solo el host agent.financial.md devuelve esta respuesta. Una ruta de pago en ese host requiere un pago: la cabecera PAYMENT-REQUIRED contiene el precio y las condiciones. Paga con x402 y vuelve a enviar la llamada, o llama a la misma ruta en api.financial.md sin clave, dentro de los límites diarios. Consulta Precios.
unknown_company (404)
Ninguna empresa coincide con el parámetro company. Prueba con el CIK (cik:320193) o busca con GET /v1/companies?q=. Una empresa excluida de cotización no se puede buscar por símbolo bursátil: usa su CIK. GET /v1/companies?status=delisted muestra la lista de estas empresas.
unknown_concept (404)
El identificador del concepto o ratio no está en la plantilla de la empresa. GET /v1/company/metrics muestra la lista de identificadores.
not_found (404)
La ruta, la presentación ante la SEC (documento presentado) o el identificador de prueba no existe. Comprueba el número de acceso o el identificador de prueba.
not_covered (404)
La empresa es conocida, pero este conjunto de datos no está disponible para ella. El cuerpo de la respuesta enumera available_datasets. Una entidad que presenta información conforme a IFRS tiene presentaciones ante la SEC (documentos presentados), pero aún no tiene estados financieros estandarizados.
rate_limited (429)
Se ha agotado el límite diario para esta clase de ruta. Espera el número de segundos indicado en Retry-After. Los límites figuran en la página de documentación. Aún no se emiten claves con límites más altos.
upstream_unavailable (503)
La API no pudo conectarse a su base de datos. Vuelve a intentarlo tras una breve espera. El request_id nos ayuda a encontrar la llamada.