Retrieve a list of OpenLineage jobs tracked in the workspace.
Returns a paginated list of OpenLineage jobs, including job identifiers, namespace, name, and associated run details such as run count, last run time, and last run status.
GET https://[hostname]/api/v1/openlineage/jobs
Request Parameters
Filtering and pagination
| Parameter | Type | Required | Description |
|---|---|---|---|
| offset | integer | No |
Number of records to skip before returning results. |
| limit | integer | No |
Maximum number of records to return. |
Additional query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| namespace | string | No | Filter results by namespace |
Request Examples
Each example shows how to call this endpoint with the documented method, URL, headers, and request body format.
curl -X GET "/api/v1/openlineage/jobs" \
-H "Authorization: Bearer <JWT>"
fetch("/api/v1/openlineage/jobs", {
method: "GET",
headers: {
"Authorization": "Bearer <JWT>"
}
})
.then(res => res.json())
.then(data => console.log(data));
import json
import requests
url = "/api/v1/openlineage/jobs"
headers = {
"Authorization": "Bearer <JWT>"
}
payload = None
response = requests.get(url, headers=headers)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
body := http.NoBody
req, _ := http.NewRequest("GET", "/api/v1/openlineage/jobs", body)
req.Header.Set("Authorization", "Bearer <JWT>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body2, _ := io.ReadAll(resp.Body)
fmt.Println(string(body2))
}
Success Responses
This payload returns a paginated list of tracked OpenLineage jobs with pagination metadata and job entries.
For customers, this means you can enumerate known jobs and review job-level details such as namespace, name, run count, and recent run status fields.
Representative payload generated from the response schema.
{
"total": 0,
"offset": 0,
"limit": 0,
"jobs": [
{
"id": "string",
"namespace": "string",
"name": "string",
"description": "string",
"owners": [
"string"
],
"runCount": 0,
"lastRunTime": "string",
"lastRunStatus": "string",
"createdAt": "string",
"updatedAt": "string"
}
]
}Error Responses
None