> ## Documentation Index > Fetch the complete documentation index at: https://docs.maia.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi/public-api-endpoint-reference.yaml get /v1/lineage/events openapi: 3.1.0 info: title: Maia Public REST API version: '1.0' servers: - description: EU1 url: https://eu1.api.matillion.com/dpc - description: US1 url: https://us1.api.matillion.com/dpc security: - bearerAuth: [] tags: - description: Manage Schedules name: Schedules - description: Manage Connections name: Connections - description: Operations for managing Project Variables name: Project Variables - description: Manage Pipelines name: Pipelines - description: Review pipelines against quality rules name: Pipeline Quality Review - description: Execute tests within a project name: Test Execution - description: Manage your AI agent tasks name: AI Agent Tasks - description: SCIM endpoints for user/group permission management name: Directory Integration - description: Publish shared pipeline artifacts name: Shared Pipeline Artifacts - description: Manage Repositories name: Repositories - description: Report on Credit Consumption name: Consumption - description: Manage Artifacts name: Artifacts - description: Operations for data lineage and governance name: Data Lineage - description: Manage Streaming Pipelines name: Streaming Pipelines - description: Execute a pipeline name: Pipeline Execution - description: '' name: Environments - description: '' name: Projects - description: Manage Agents name: Agents - description: Operations for managing Environment-level Overrides of Project Variables name: Project Variable Environment Overrides - description: Query audit events name: Audit Events - description: Connector Profiles name: Connectors paths: /v1/lineage/events: get: tags: - Data Lineage summary: Get OpenLineage events for a specified time period description: >- 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. operationId: get-lineage-events parameters: - description: >- Include events generated from this datetime (inclusive). Must be before generatedBefore. example: '2025-01-01T00:00:00.000Z' in: query name: generatedFrom required: true schema: type: string format: date-time - description: >- Include events generated before this datetime (exclusive). Must be after generatedFrom. example: '2025-01-02T00:00:00.000Z' in: query name: generatedBefore required: true schema: type: string format: date-time - description: Page number for pagination (0-indexed). Must be 0 or greater. example: 0 in: query name: page required: true schema: type: integer format: int32 - description: Number of records per page. Must be between 1 and 100 inclusive. example: 25 in: query name: size required: false schema: type: integer format: int32 default: 100 responses: '200': content: application/json: examples: Lineage Events Response: description: Lineage Events Response value: 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://. 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 schema: $ref: '#/components/schemas/PagedResultList' description: Successfully retrieved lineage events '400': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: >- Invalid request parameters (e.g., invalid date range, invalid pagination parameters) '403': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: >- Access forbidden - user does not have permission to access this account '404': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Data governance resource not found for the requested parameters '500': content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetail' description: Internal server error components: schemas: PagedResultList: type: object properties: page: type: integer format: int32 description: The 0-indexed page number of the returned results. example: 1 results: type: array description: Page of results or empty. items: {} size: type: integer format: int32 description: The size of each page of results. example: 50 total: type: integer format: int64 description: Total number of available results across all pages. example: 472 ProblemDetail: type: object properties: detail: type: string instance: type: string status: type: integer format: int32 title: type: string type: type: string format: uri violations: type: array items: type: string securitySchemes: bearerAuth: bearerFormat: JWT description: a valid bearer token scheme: bearer type: http ````