Obtener un run
get /v1/runs/{run_id}
Estado y resultado de un run. Es lo que se consulta cuando POST /v1/runs respondió 202 y no quieres depender del webhook.
Autenticación
Requiere API key (sk_live_… · sk_test_…) en la cabecera
authorization: Bearer …. Ver autenticación.
Parámetros
| Nombre | En | Tipo | Descripción |
|---|---|---|---|
run_idobligatorio | path | string | — |
Respuesta 200
Run
run_id string obligatorio
flow string obligatorio
flow_version integer obligatorio
status enum obligatorio
queuedrunningawaiting_confirmationsucceededfailedexpiredcancelled
data object | null obligatorio
document object | null obligatorio
type enum obligatorio
pdfjsonscreenshothtml
download_url string obligatorio
expires_at string obligatorio
sha256 string obligatorio
bytes integer obligatorio
documents object[]
Por omisión: []
type enum obligatorio
pdfjsonscreenshothtml
download_url string obligatorio
expires_at string obligatorio
sha256 string obligatorio
bytes integer obligatorio
source_meta object | null obligatorio
driver string obligatorio
obtained_at string obligatorio
portal string obligatorio
portal_ref string
duration_ms integer
attempts integer
error object | null obligatorio
code enum obligatorio
invalid_paramscredential_invalidcredential_expiredportal_unavailableportal_changednot_foundrate_limitedflow_disabledinternal_errorauthentication_errorpermission_deniedconflict
message string obligatorio
execution_token string
execution_token_expires_at string
session_id string | null
parent_run_id string | null
created_at string obligatorio
finished_at string | null obligatorio
Errores
| Código | Cuándo |
|---|---|
404 | No existe |
El cuerpo de cualquier error sigue la misma forma y su code viene de un
catálogo cerrado. Ver errores.