Skip to content

Get Lineage Failures

GET
/api/v1/lineage/failures

Get failed lineage entries with pagination.

Useful for operational monitoring and debugging.

Args: service: Lineage service (injected) stage_name: Filter by stage name route_id: Filter by route ID execution_id: Filter by execution ID limit: Maximum results (default: 20, max: 100) offset: Pagination offset

Returns: LineageFailuresResponse with failures and pagination

stage_name
Any of:
string

Filter by stage name

route_id
Any of:
string

Filter by route ID

execution_id
Any of:
string format: uuid

Filter by execution ID

limit
Limit

Max results per page

integer
default: 20 >= 1 <= 100

Max results per page

offset
Offset

Offset for pagination

integer
0

Offset for pagination

Successful Response

LineageFailuresResponse

Paginated failure list.

object
failures
required
Failures

Failed 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
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
total
required
Total

Total number of failures

integer
limit
required
Limit

Maximum entries per page

integer
offset
required
Offset

Offset from start

integer
has_more
required
Has More

Whether more failures exist

boolean

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