List all runs

Returns a list of runs for a job.

Path Parameters

namespace string required

Possible values: <= 1024 characters

The name of the namespace.

job string required

Possible values: <= 1024 characters

The name of the job.

Query Parameters

limit integer

Default value: 100

The number of results to return from offset.

offset integer

The initial position from which to return results.

Responses

• 200

---

OK

application/json

Schema

Example (from schema)

---

Schema

runs object[]
Array [
anyOf
IncompleteRun
MOD2
---
id uuid
The ID of the run.
createdAt date-time
An ISO-8601 timestamp representing the date/time the run was created.
updatedAt date-time
An ISO-8601 timestamp representing the date/time the run was updated.
nominalStartTime date-time
An ISO-8601 timestamp representing the nominal start time of the run.
nominalEndTime date-time
An ISO-8601 timestamp representing the nominal end time of the run.
state string
Possible values: [NEW, RUNNING, COMPLETED, FAILED, ABORTED]
The current state of the run.
startedAt date-time
An ISO-8601 timestamp representing the start time of the run.
endedAt date-time
An ISO-8601 timestamp representing the end time of the run.
durationMs integer
The total duration of the run. Measured in milliseconds.
args object
The arguments of the run.
facets object
The facets of the run. For a full list of standard run facets, see OpenLineage.
description
allOf
title
jobVersion object
namespace string
The namespace of the job.
name string
The name of the job.
version uuid
The version of the job.
inputDatasetVersions object[]
Array [
datasetVersionId object required
namespace string required
The namespace of the dataset.
name string required
The name of the dataset.
version uuid required
The version of the dataset.
facets object required
Dataset facets in run context, like inputFacets.
property name* string
]
outputDatasetVersions object[]
Array [
datasetVersionId object required
namespace string required
The namespace of the dataset.
name string required
The name of the dataset.
version uuid required
The version of the dataset.
facets object required
Dataset facets in run context, like outputFacets.
property name* string
]
context object deprecated
A key/value pair that must be of type string. A context can be used for getting additional details about the job.
facets object
The facets of the run. For a full list of standard run facets, see OpenLineage.
description
allOf
title
]

{
  "runs": [
    {
      "id": "870492da-ecfb-4be0-91b9-9a89ddd3db90",
      "createdAt": "2019-05-09T19:49:24.201361Z",
      "updatedAt": "2019-05-09T19:49:24.201361Z",
      "nominalStartTime": null,
      "nominalEndTime": null,
      "state": "RUNNING",
      "startedAt": "2019-05-09T15:17:32.690346",
      "endedAt": null,
      "durationMs": null,
      "args": {
        "email": "me@example.com",
        "emailOnFailure": "false",
        "emailOnRetry": "true",
        "retries": "1"
      },
      "facets": {}
    },
    {}
  ]
}

GET /namespaces/:namespace/jobs/:job/runs

Request

Base URL

http://localhost:5000/api/v1

namespace — path required

job — path required

limit — query

offset — query

curl / cURL

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

python / requests

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

go / native

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

nodejs / axios

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

ruby / Net::HTTP

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

csharp / RestSharp

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

php / cURL

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

java / OkHttp

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'

powershell / RestMethod

curl -L -X GET 'http://localhost:5000/api/v1/namespaces/:namespace/jobs/:job/runs' \
-H 'Accept: application/json'