---
title: "GET /v2/domains/{domainIdentifier}/lineage/events"
method: GET
path: "/v2/domains/{domainIdentifier}/lineage/events"
---

# GET /v2/domains/{domainIdentifier}/lineage/events

`GET /v2/domains/{domainIdentifier}/lineage/events`

Lists lineage events.

## Path parameters

- `domainIdentifier` string, required

## Query parameters

- `maxResults` integer
- `timestampAfter` string, date-time
- `timestampBefore` string, date-time
- `processingStatus` 'REQUESTED' | 'PROCESSING' | 'SUCCESS' | 'FAILED'
- `sortOrder` 'ASCENDING' | 'DESCENDING'
- `nextToken` string

## Response `200`

Success

- ListLineageEventsOutput
  - `items` LineageEventSummary[] — The results of the ListLineageEvents action.
    - `id` string — The ID of the data lineage event.
    - `domainId` string — The domain ID of the lineage event.
    - `processingStatus` 'REQUESTED' | 'PROCESSING' | 'SUCCESS' | 'FAILED' — The processing status of the data lineage event.
    - `eventTime` string, date-time — The time of the data lineage event.
    - `eventSummary` object — The summary of the data lineate event.
      - `openLineageRunEventSummary` object — The open lineage run event summary.
        - `eventType` 'START' | 'RUNNING' | 'COMPLETE' | 'ABORT' | 'FAIL' | 'OTHER' — The event type of the open lineage run event summary.
        - `runId` string — The runID of the open lineage run event summary.
        - `job` object — The job of the open lineage run event summary.
          - `name` string — The name in the name identifier.
          - `namespace` string — The namespace in the name identifier.
        - `inputs` NameIdentifier[] — The inputs of the open lineage run event summary.
          - `name` string — The name in the name identifier.
          - `namespace` string — The namespace in the name identifier.
        - `outputs` NameIdentifier[] — The outputs of the open lineage run event summary.
          - `name` string — The name in the name identifier.
          - `namespace` string — The namespace in the name identifier.
    - `createdBy` string — The user who created the data lineage event.
    - `createdAt` string, date-time — The timestamp at which data lineage event was created.
  - `nextToken` string — When the number of lineage events is greater than the default value for the MaxResults parameter, or if you explicitly specify a value for MaxResults that is less than the number of lineage events, the response includes a pagination token named NextToken. You can specify this NextToken value in a subsequent call to ListLineageEvents to list the next set of lineage events.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — UnauthorizedException

---

[API](https://skmtc.net/aws/apis/datazone.md) · [All operations](https://skmtc.net/aws/apis/datazone/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/datazone/versions/055599054b53/schema)