Skip to content

Get Lineage Entry

GET
/api/v1/lineage/{correlation_id}

Get a single lineage entry by correlation ID.

Args: correlation_id: Correlation ID to lookup service: Lineage service (injected)

Returns: LineageEntryResponse with entry details

Raises: HTTPException: 404 if not found

correlation_id
required
Correlation Id
string

Successful Response

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
replay_batch_id
Any of:
string
execution_id
Any of:
string format: uuid
route_id
Any of:
string
adapter_name
Any of:
string
adapter_index
Any of:
integer
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
started_at
required
Started At

When processing started

string format: date-time
completed_at
Any of:
string format: date-time
duration_ms
Any of:
number
metadata
Any of:
object
key
additional properties
any
error_info
Any of:
object
key
additional properties
any

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
correlation_id
Any of:
string
timestamp
Timestamp

Error timestamp

string format: date-time

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