Retrieve detailed information for a specific OpenLineage run by run ID.
Returns run-level details, including the run ID, job namespace and name, execution status, start and end times, input and output datasets, and the list of associated events.
GET https://[hostname]/api/v1/openlineage/runs/{runId}
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| runId | string | Yes |
Unique identifier for the run (UUID) |
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/runs/{runId}" \
-H "Authorization: Bearer <JWT>"
fetch("/api/v1/openlineage/runs/{runId}", {
method: "GET",
headers: {
"Authorization": "Bearer <JWT>"
}
})
.then(res => res.json())
.then(data => console.log(data));
import json
import requests
url = "/api/v1/openlineage/runs/{runId}"
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/runs/{runId}", 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 the details for the requested OpenLineage run.
It includes run and job identifiers, execution status and timing, input and output datasets, optional parent run linkage, and the related event list.
Representative payload generated from the response schema.
{
"runId": "string",
"jobNamespace": "string",
"jobName": "string",
"jobAssetId": "string",
"status": "STARTED",
"startTime": "string",
"endTime": "string",
"inputDatasets": [
{
"namespace": "string",
"name": "string",
"assetId": "string"
}
],
"outputDatasets": [
{
"namespace": "string",
"name": "string",
"assetId": "string"
}
],
"parentRunId": "string",
"events": [
{}
],
"createdAt": "string",
"updatedAt": "string"
}Error Responses
This payload indicates that no run exists for the provided run ID.
Representative payload generated from the response schema.
{
"statusCode": 404,
"code": "string",
"error": "string",
"message": "string",
"validationErrors": [
{
"path": "string",
"message": "string"
}
]
}