List runs for a job

GET

/api/v1/jobs/{jobDefinitionId}/runs

• Generated server url

Returns run history for one job after VIEW permission. Status values are case-insensitive; paging defaults to page 0 and size 50 with a size cap of 200.

Authorizations

• sessionCookie

Parameters

Path Parameters

jobDefinitionId

required

string format: uuid

Job definition identifier.

Query Parameters

status

Array<string>

Optional repeated run statuses: PENDING, RUNNING, SUCCEEDED, FAILED, CANCEL_REQUESTED, CANCELLED, or RETRY_SCHEDULED.

from

string format: date-time

Inclusive lower timestamp bound in UTC ISO-8601 date-time format.

to

string format: date-time

Exclusive upper timestamp bound in UTC ISO-8601 date-time format.

page

string

default: 0

Zero-based page number.

size

string

default: 50 >= 1 <= 200

Requested page size, clamped to the range 1 through 200.

Responses

200

Job run history returned

Zero-based page of resource results.

object

content

Results in this page.

Array<object>

Public durable run state and attempt lineage. Lease tokens and resolved datasource security are never exposed.

object

attempt

One-based attempt number.

integer format: int32

>= 1

availableAt

Earliest database time at which this attempt is eligible for claim.

string format: date-time

cancellationWarning

Mode-specific warning about sink state after cancellation.

string

nullable

committedWatermark

Incremental watermark committed only by successful finalization.

string

nullable

createdAt

Run creation timestamp in UTC.

string format: date-time

durationMillis

Elapsed execution time in milliseconds when reported.

integer format: int64

nullable

errorMessage

Credential-redacted failure detail.

string

nullable

executorIdentity

Worker identity assigned after claim.

string

nullable

finishedAt

Terminal completion timestamp in UTC.

string format: date-time

nullable

heartbeatAt

Most recent successful worker heartbeat in UTC.

string format: date-time

nullable

id

Run attempt identifier.

string format: uuid

jobDefinitionId

Owning job definition identifier.

string format: uuid

leaseUntil

Current claim expiry timestamp in UTC.

string format: date-time

nullable

previousRunId

Previous attempt in the retry chain.

string format: uuid

nullable

rowsProcessed

Rows processed by this attempt when reported.

integer format: int64

nullable

startedAt

Execution start timestamp in UTC.

string format: date-time

nullable

status

Durable lifecycle state.

string

Allowed values: PENDING RUNNING SUCCEEDED FAILED CANCEL_REQUESTED CANCELLED RETRY_SCHEDULED

page

Zero-based page number.

integer format: int32

size

Effective page size, from 1 through 200.

integer format: int32

>= 1 <= 200

totalElements

Total matching resources across all pages.

integer format: int64

400

The request is malformed or fails validation.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object

detail

string

instance

string format: uri-reference

status

integer format: int32

title

string

type

string format: uri-reference

401

Authentication is required or credentials are invalid.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object

detail

string

instance

string format: uri-reference

status

integer format: int32

title

string

type

string format: uri-reference

403

The authenticated identity lacks the required permission.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object

detail

string

instance

string format: uri-reference

status

integer format: int32

title

string

type

string format: uri-reference

404

The requested resource does not exist or is not visible.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object

detail

string

instance

string format: uri-reference

status

integer format: int32

title

string

type

string format: uri-reference