Runs

Read the runs of a job or a whole project, and the attempts within each one.

The run object

{
  "id": "01m3c081dbf3j55x7hsa7wc1yj",
  "jobId": "01m3c081d2wj4g63qcr53pa1yh",
  "scheduledFor": "2026-09-25T23:00:00Z",
  "trigger": "schedule",
  "status": "succeeded",
  "attempts": 1,
  "skippedBefore": 0,
  "nextAttemptAt": null,
  "firstAttemptAt": "2026-09-25T23:00:00.812Z",
  "finishedAt": "2026-09-25T23:00:01.034Z",
  "lastStatusCode": 200,
  "lastError": "",
  "lastErrorClass": "",
  "createdAt": "2026-09-25T23:00:00.401Z"
}

scheduledForstring: When the run was due. For a run started with Run now, when it was started.
triggerstring: schedule or manual.
statusstring: pending, running, retry_wait, succeeded, failed, or cancelled. See Run statuses.
attemptsinteger: How many attempts have been made.
skippedBeforeinteger: How many earlier occurrences were missed and folded into this run.
nextAttemptAtstring or null: When the next attempt is due, while the run is waiting to retry.
lastStatusCodeinteger or null: The status your target answered the last attempt with. null when it did not answer.
lastErrorstring: What went wrong in the last attempt, when it failed.
lastErrorClassstring: Why the last attempt failed. See Why attempts fail.

List runs

GET/v1/projects/{project}/jobs/{job}/runs

Returns the job’s runs from the last 30 days, newest first, a page at a time. See Paging.

List a project’s runs

GET/v1/projects/{project}/runs

Returns the runs of every job in the project from the last 30 days, newest first, a page at a time. Narrow the list with any of these query parameters:

jobstring: Only this job’s runs.
statusstring: Only runs with this status: pending, running, retry_wait, succeeded, failed, or cancelled.
triggerstring: Only runs started this way: schedule or manual.

Read a run

GET/v1/projects/{project}/jobs/{job}/runs/{run}

Returns the run with attemptList, one entry for each attempt:

numberinteger: The attempt number, from 1.
startedAtstring: When the call was made.
durationMsinteger: How long the call took, in milliseconds.
statusCodeinteger or null: The status your target answered with.
errorClassstring: Why the attempt failed, or empty when it succeeded.
errorstring: What went wrong, or empty when it succeeded.
responseExcerptstring: The first 4 KB of your target’s answer.

Last updated 26 September 2026