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
}
]
}
}
]
}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.
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
}
]
}
}
]
}a valid bearer token
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.
Successfully retrieved lineage events
Was this page helpful?