Skip to main content
GET
Retrieve events

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

start
integer<int64>
required

Start timestamp (UNIX epoch). Only events with event_time >= this value are returned.

Example:

1672531200

end
integer<int64>
required

End timestamp (UNIX epoch). Only events with event_time < this value are returned.

Example:

1672617600

sort_by
enum<string>
default:EVENT_TIME

Field by which results should be sorted. Defaults to EVENT_TIME.

Available options:
EVENT_TIME,
EVENT_SIZE_IN_BYTES
order
enum<string>
default:DESC

Sort order. Defaults to DESC.

Available options:
ASC,
DESC
run
string<uuid>

Filter by run_id (UUID). Only events matching this run_id are returned.

Example:

"550e8400-e29b-41d4-a716-446655440000"

states
enum<string>

Comma-separated list of run states to filter by. E.g. 'START,RUNNING,COMPLETE'.

Available options:
START,
RUNNING,
COMPLETE,
ABORT,
FAIL,
OTHER
namespace
string

Filter by job namespace, partial matches included.

Example:

"my-scheduler-namespace"

job
string

Filter by job name, partial matches included.

Example:

"myjob.mytask"

integrations
string

Comma-separated list of integration names to filter by.

Example:

"airflow,dbt"

limit
integer
default:30

Number of results to return. Defaults to 30.

Example:

50

offset
integer
default:0

Offset for pagination. Defaults to 0.

Example:

100

Response

A list of lineage events.

id
string<uuid>
required
run_id
string<uuid>
required
run_state
enum<string>
required
Available options:
START,
RUNNING,
COMPLETE,
ABORT,
FAIL,
OTHER
received_at
string<date-time>
required

Timestamp with offset, e.g. '2023-07-14T12:34:56Z'.

job_name
string
required
job_namespace
string
required
event_time
string<date-time>
required

Event occurrence time (with offset).

event_schema
string<uri>
required
event_schema_version
string
required
event_size_in_bytes
integer
required

Size of the raw event payload in bytes.

event_raw
Run Event · object
required

Arbitrary structure corresponding to rawLineageEventSchema.

produced_by
string<uri>
required
integration
string
required
integration_version
string
required
parent_run_id
string<uuid> | null

Optional parent run ID.

parent_job_namespace
string | null

Optional parent job namespace.

parent_job_name
string | null

Optional parent job name.

inputs
object[] | null

List of input datasets.

outputs
object[] | null

List of output datasets.