Overview Returns full information about a run, including its status, payload, output, metadata, and all attempt history. If authenticated with a Public API key, payload and output are omitted for security.
Endpoint GET https://api.trigger.dev/api/v3/runs/{runId}
Path parameters The unique run ID, prefixed with run_.
Response Unique run ID, prefixed with run_.
Current status. One of: PENDING_VERSION, DELAYED, QUEUED, EXECUTING, REATTEMPTING, FROZEN, COMPLETED, CANCELED, FAILED, CRASHED, INTERRUPTED, SYSTEM_FAILURE.
Worker version that executed the run.
Idempotency key used when triggering, if provided.
Whether this is a test run.
The payload passed to the task (omitted for Public API keys).
The output returned by the task (omitted for Public API keys).
Key-value metadata attached to the run.
Tags attached to the run.
ISO 8601 creation timestamp.
ISO 8601 last-updated timestamp.
If delayed, when the run will be enqueued.
Time-to-live set on the run, if any.
If the TTL elapsed before execution, when the run expired.
Compute cost in cents (excludes DEV).
Invocation cost in cents (excludes DEV).
Total compute time in ms (excludes waits).
Depth in the task hierarchy. Root runs have depth 0.
Batch ID if this run was created as part of a batch.
One of trigger, triggerAndWait, batchTrigger, batchTriggerAndWait.
Runs related to this one in the task hierarchy. The root run of the hierarchy (if not the root itself).
The parent run (if not the root).
Schedule that triggered the run, if applicable. Schedule ID, prefixed with sched_.
Optional external ID set when creating the schedule.
Deduplication key of the schedule.
CRON generator info: type, expression, description.
History of all execution attempts. Attempt ID, prefixed with attempt_.
One of PENDING, EXECUTING, PAUSED, COMPLETED, FAILED, CANCELED.
Error details if the attempt failed: message, name, stackTrace.
ISO 8601 creation timestamp.
When the attempt started.
When the attempt completed.
Examples import { runs } from "@trigger.dev/sdk" ; const run = await runs . retrieve ( "run_p4omhh45hgxxnq1re6ovy" ); // Convenience boolean helpers if ( run . isSuccess ) { console . log ( "Output:" , run . output ); } else if ( run . isFailed ) { console . log ( "Failed. Last attempt error:" , run . attempts . at ( - 1 )?. error ); } console . log ( "Status:" , run . status ); console . log ( "Payload:" , run . payload ); for ( const attempt of run . attempts ) { if ( attempt . status === "FAILED" ) { console . log ( "Attempt failed:" , attempt . error ); } }
Response example { "id" : "run_p4omhh45hgxxnq1re6ovy" , "status" : "COMPLETED" , "taskIdentifier" : "my-task" , "version" : "20240523.1" , "isTest" : false , "payload" : { "message" : "Hello, world!" }, "output" : { "result" : "done" }, "tags" : [ "user_5df987al13" ], "createdAt" : "2024-04-01T12:00:00Z" , "updatedAt" : "2024-04-01T12:00:05Z" , "startedAt" : "2024-04-01T12:00:01Z" , "finishedAt" : "2024-04-01T12:00:05Z" , "durationMs" : 4200 , "costInCents" : 0.00292 , "baseCostInCents" : 0.0025 , "depth" : 0 , "attempts" : [ { "id" : "attempt_1234" , "status" : "COMPLETED" , "createdAt" : "2024-04-01T12:00:01Z" , "startedAt" : "2024-04-01T12:00:01Z" , "completedAt" : "2024-04-01T12:00:05Z" } ] }
