List Lineage Entries

GET

/api/v1/lineage

List lineage entries with filters and pagination.

Provides paginated access to lineage entries with provenance-based filtering. Metadata filters query the JSONB metadata column for provenance fields (origin, url, title, document_id) that are accumulated during pipeline processing.

Parameters

Query Parameters

execution_id

Any of:

string

string format: uuid

null

null

Filter by execution ID

route_id

Any of:

string

string

null

null

Filter by route ID

status

Any of:

string

string

null

null

Filter by status (initiated, processing, completed, failed)

is_root

Any of:

boolean

boolean

null

null

Filter for root entries only (parent_correlation_id IS NULL)

url

Any of:

string

string

null

null

Filter by source URL (case-insensitive partial match on metadata)

origin

Any of:

string

string

null

null

Filter by origin hostname (case-insensitive partial match on metadata)

title

Any of:

string

string

null

null

Filter by title (case-insensitive partial match on metadata)

document_id

Any of:

string

string

null

null

Filter by document ID (exact match on metadata)

started_after

Any of:

string

string format: date-time

null

null

Filter entries started at or after this time (ISO 8601)

started_before

Any of:

string

string format: date-time

null

null

Filter entries started at or before this time (ISO 8601)

sort_by

Sort By

Sort field: started_at, completed_at, route_id, stage_name

string

default: started_at

Sort field: started_at, completed_at, route_id, stage_name

sort_order

Sort Order

Sort direction: asc or desc

string

default: asc

Sort direction: asc or desc

limit

Limit

Max results per page

integer

default: 100 >= 1 <= 1000

Max results per page

offset

Offset

Offset for pagination

integer

0

Offset for pagination

Responses

200

Successful Response

LineageListResponse

Paginated lineage list.

object

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

total

required

Total

Total number of entries

integer

limit

required

Limit

Maximum entries per page

integer

offset

required

Offset

Offset from start

integer

has_more

required

Has More

Whether more entries exist

boolean

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