Get OpenLineage events for a specified time period
curl --request GET \
--url https://eu1.api.matillion.com/dpc/v1/lineage/events \
--header 'Authorization: Bearer <token>'{
"page": 0,
"size": 1,
"total": 1,
"results": [
{
"id": "12345678-1234-1234-1234-123456789012",
"event": {
"eventType": "RUNNING",
"eventTime": "2025-10-13T09:12:10.741Z",
"producer": "https://www.matillion.com",
"schemaURL": "https://openlineage.io/spec/2-0-2/OpenLineage.json#/$defs/RunEvent",
"job": {
"namespace": "matillion://<account-id>.<project-id>",
"name": "path/to/data-pipeline.orch.yaml",
"facets": {
"jobType": {
"jobType": "ORCHESTRATION",
"integration": "MATILLION",
"processingType": "BATCH",
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/2-0-3/JobTypeJobFacet.json#/$defs/JobTypeJobFacet"
},
"documentation": null,
"sourceCode": null,
"sourceCodeLocation": null,
"sql": null,
"ownership": null
}
},
"run": {
"runId": "9876543210-abcd-1234-efgh-567890123456",
"facets": null
},
"inputs": [
{
"namespace": "postgresql://postgres-host.example.com:5432",
"name": "source_schema.source_table",
"facets": {
"schema": {
"fields": [
{
"name": "int_field",
"type": "INTEGER",
"description": null
},
{
"name": "varchar_255",
"type": "VARCHAR",
"description": null
},
{
"name": "bool_field",
"type": "BOOLEAN",
"description": null
}
],
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/1-1-1/SchemaDatasetFacet.json#/$defs/SchemaDatasetFacet"
},
"dataSource": null,
"columnLineage": null
},
"inputFacets": null
}
],
"outputs": [
{
"namespace": "snowflake://account-name.region",
"name": "TARGET_DATABASE.TARGET_SCHEMA.TARGET_TABLE",
"facets": {
"schema": {
"fields": [
{
"name": "int_field",
"type": "NUMBER",
"description": null
},
{
"name": "varchar_255",
"type": "VARCHAR(16777216)",
"description": null
},
{
"name": "bool_field",
"type": "BOOLEAN",
"description": null
}
],
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/1-1-1/SchemaDatasetFacet.json#/$defs/SchemaDatasetFacet"
},
"columnLineage": {
"fields": {
"int_field": {
"inputFields": [
{
"namespace": "postgresql://postgres-host.example.com:5432",
"name": "source_schema.source_table",
"field": "int_field"
}
]
},
"varchar_255": {
"inputFields": [
{
"namespace": "postgresql://postgres-host.example.com:5432",
"name": "source_schema.source_table",
"field": "varchar_255"
}
]
}
},
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json#/$defs/ColumnLineageDatasetFacet"
}
},
"outputFacets": null
}
]
}
}
]
}Data Lineage
Get OpenLineage events for a specified time period
Retrieves OpenLineage events in standard OpenLineage format. Events are returned in chronological order within the specified date range and include complete lineage information such as job runs, datasets, and transformations. The date range must be valid (generatedFrom must be before generatedBefore). Use pagination to handle large result sets efficiently.
GET
/
v1
/
lineage
/
events
Get OpenLineage events for a specified time period
curl --request GET \
--url https://eu1.api.matillion.com/dpc/v1/lineage/events \
--header 'Authorization: Bearer <token>'{
"page": 0,
"size": 1,
"total": 1,
"results": [
{
"id": "12345678-1234-1234-1234-123456789012",
"event": {
"eventType": "RUNNING",
"eventTime": "2025-10-13T09:12:10.741Z",
"producer": "https://www.matillion.com",
"schemaURL": "https://openlineage.io/spec/2-0-2/OpenLineage.json#/$defs/RunEvent",
"job": {
"namespace": "matillion://<account-id>.<project-id>",
"name": "path/to/data-pipeline.orch.yaml",
"facets": {
"jobType": {
"jobType": "ORCHESTRATION",
"integration": "MATILLION",
"processingType": "BATCH",
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/2-0-3/JobTypeJobFacet.json#/$defs/JobTypeJobFacet"
},
"documentation": null,
"sourceCode": null,
"sourceCodeLocation": null,
"sql": null,
"ownership": null
}
},
"run": {
"runId": "9876543210-abcd-1234-efgh-567890123456",
"facets": null
},
"inputs": [
{
"namespace": "postgresql://postgres-host.example.com:5432",
"name": "source_schema.source_table",
"facets": {
"schema": {
"fields": [
{
"name": "int_field",
"type": "INTEGER",
"description": null
},
{
"name": "varchar_255",
"type": "VARCHAR",
"description": null
},
{
"name": "bool_field",
"type": "BOOLEAN",
"description": null
}
],
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/1-1-1/SchemaDatasetFacet.json#/$defs/SchemaDatasetFacet"
},
"dataSource": null,
"columnLineage": null
},
"inputFacets": null
}
],
"outputs": [
{
"namespace": "snowflake://account-name.region",
"name": "TARGET_DATABASE.TARGET_SCHEMA.TARGET_TABLE",
"facets": {
"schema": {
"fields": [
{
"name": "int_field",
"type": "NUMBER",
"description": null
},
{
"name": "varchar_255",
"type": "VARCHAR(16777216)",
"description": null
},
{
"name": "bool_field",
"type": "BOOLEAN",
"description": null
}
],
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/1-1-1/SchemaDatasetFacet.json#/$defs/SchemaDatasetFacet"
},
"columnLineage": {
"fields": {
"int_field": {
"inputFields": [
{
"namespace": "postgresql://postgres-host.example.com:5432",
"name": "source_schema.source_table",
"field": "int_field"
}
]
},
"varchar_255": {
"inputFields": [
{
"namespace": "postgresql://postgres-host.example.com:5432",
"name": "source_schema.source_table",
"field": "varchar_255"
}
]
}
},
"_producer": "https://www.matillion.com",
"_schemaURL": "https://openlineage.io/spec/facets/1-2-0/ColumnLineageDatasetFacet.json#/$defs/ColumnLineageDatasetFacet"
}
},
"outputFacets": null
}
]
}
}
]
}Authorizations
a valid bearer token
Query Parameters
Include events generated from this datetime (inclusive). Must be before generatedBefore.
Include events generated before this datetime (exclusive). Must be after generatedFrom.
Page number for pagination (0-indexed). Must be 0 or greater.
Number of records per page. Must be between 1 and 100 inclusive.
Response
Successfully retrieved lineage events
Was this page helpful?
⌘I
