---
title: "GET /v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs"
method: GET
path: "/v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs"
---

# GET /v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs

`GET /v2/domains/{domainIdentifier}/data-sources/{dataSourceIdentifier}/runs`

Lists data source runs in Amazon DataZone.

## Path parameters

- `domainIdentifier` string, required
- `dataSourceIdentifier` string, required

## Query parameters

- `status` 'REQUESTED' | 'RUNNING' | 'FAILED' | 'PARTIALLY_SUCCEEDED' | 'SUCCESS'
- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListDataSourceRunsOutput
  - `items` DataSourceRunSummary[], required — The results of the <code>ListDataSourceRuns</code> action.
    - `id` string, required — The identifier of the data source run.
    - `dataSourceId` string, required — The identifier of the data source of the data source run.
    - `type` 'PRIORITIZED' | 'SCHEDULED', required — The type of the data source run.
    - `status` 'REQUESTED' | 'RUNNING' | 'FAILED' | 'PARTIALLY_SUCCEEDED' | 'SUCCESS', required — The status of the data source run.
    - `projectId` string, required — The project ID of the data source run.
    - `runStatisticsForAssets` RunStatisticsForAssets — The asset statistics from the data source run.
      - `added` integer — The <code>added</code> statistic for the data source run.
      - `updated` integer — The <code>updated</code> statistic for the data source run.
      - `unchanged` integer — The <code>unchanged</code> statistic for the data source run.
      - `skipped` integer — The <code>skipped</code> statistic for the data source run.
      - `failed` integer — The <code>failed</code> statistic for the data source run.
    - `errorMessage` DataSourceErrorMessage — The details of the error message that is returned if the operation cannot be successfully completed.
      - `errorType` 'ACCESS_DENIED_EXCEPTION' | 'CONFLICT_EXCEPTION' | 'INTERNAL_SERVER_EXCEPTION' | 'RESOURCE_NOT_FOUND_EXCEPTION' | 'SERVICE_QUOTA_EXCEEDED_EXCEPTION' | 'THROTTLING_EXCEPTION' | 'VALIDATION_EXCEPTION', required — The type of the error message that is returned if the operation cannot be successfully completed.
      - `errorDetail` string — The details of the error message that is returned if the operation cannot be successfully completed.
    - `createdAt` string, date-time, required — The timestamp of when a data source run was created.
    - `updatedAt` string, date-time, required — The timestamp of when a data source run was updated.
    - `startedAt` string, date-time — The timestamp of when a data source run was started.
    - `stoppedAt` string, date-time — The timestamp of when a data source run was stopped.
    - `lineageSummary` object — The run lineage summary of a data source.
      - `importStatus` 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'PARTIALLY_SUCCEEDED' — The import status that's part of the run lineage summary of a data source.
  - `nextToken` string — When the number of runs is greater than the default value for the <code>MaxResults</code> parameter, or if you explicitly specify a value for <code>MaxResults</code> that is less than the number of runs, the response includes a pagination token named <code>NextToken</code>. You can specify this <code>NextToken</code> value in a subsequent call to <code>ListDataSourceRuns</code> to list the next set of runs.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ConflictException
- `486` — ValidationException
- `487` — 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/revisions/055599054b53/schema)