---
title: "Get OpenLineage events for a specified time period"
method: GET
path: "/v1/lineage/events"
tags: ["Data Lineage"]
---

# Get OpenLineage events for a specified time period

`GET /v1/lineage/events`

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.

## Query parameters

- `generatedFrom` string, date-time, required
- `generatedBefore` string, date-time, required
- `page` integer, required
- `size` integer

## Response `200`

Successfully retrieved lineage events

- PagedResultList
  - `page` integer — The 0-indexed page number of the returned results.
  - `results` unknown[] — Page of results or empty.
    - unknown
  - `size` integer — The size of each page of results.
  - `total` integer — Total number of available results across all pages.

## Other responses

- `400` — Invalid request parameters (e.g., invalid date range, invalid pagination parameters)
- `403` — Access forbidden - user does not have permission to access this account
- `404` — Data governance resource not found for the requested parameters
- `500` — Internal server error

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)