Get Execution Lineage

GET

/api/v1/executions/{execution_id}/lineage

Get lineage entries for an execution.

Returns all lineage tracking entries associated with this execution, ordered by started_at timestamp.

Args: execution_id: Execution UUID service: Execution service (injected) lineage_service: Lineage service (injected) limit: Maximum number of results

Returns: List of lineage entries for this execution

Raises: HTTPException: 404 if execution not found

Parameters

Path Parameters

execution_id

required

Execution Id

string

Query Parameters

limit

Limit

Maximum results

integer

default: 1000 >= 1 <= 10000

Maximum results

Responses

200

Successful Response

ExecutionLineageResponse

Lineage entries for a specific execution.

object

total

required

Total

Total number of lineage entries

integer

execution_id

required

Execution Id

Execution ID these entries belong to

string format: uuid

entries

required

Entries

List of lineage entries

Array<object>

LineageEntryResponse

Pipeline lineage entry response.

object

id

required

Id

Lineage entry UUID

string format: uuid

correlation_id

required

Correlation Id

Correlation ID for this processing attempt

string

parent_correlation_id

Any of:

string

string

null

null

replay_batch_id

Any of:

string

string

null

null

execution_id

Any of:

string

string format: uuid

null

null

route_id

Any of:

string

string

null

null

adapter_name

Any of:

string

string

null

null

adapter_index

Any of:

integer

integer

null

null

stage_name

required

Stage Name

Stage name

string

stage_status

required

Stage Status

Current status of this stage

string

Allowed values: pending initiated processing completed failed cancelled

stage_input_hash

Any of:

string

string

null

null

started_at

required

Started At

When processing started

string format: date-time

completed_at

Any of:

string

string format: date-time

null

null

duration_ms

Any of:

number

number

null

null

metadata

Any of:

object

object

key

additional properties

any

null

null

error_info

Any of:

object

object

key

additional properties

any

null

null

404

Resource not found

ErrorResponse

Standard error response matching FastAPI HTTPException format.

This model is used in OpenAPI response declarations for 4xx/5xx errors. The detail field matches FastAPI’s HTTPException structure.

object

detail

required

Detail

Error message (matches FastAPI HTTPException)

string

error_code

Any of:

string

string

null

null

correlation_id

Any of:

string

string

null

null

timestamp

Timestamp

Error timestamp

string format: date-time

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object