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

# GET /v2/domains/{domainIdentifier}/projects

`GET /v2/domains/{domainIdentifier}/projects`

Lists Amazon DataZone projects.

## Path parameters

- `domainIdentifier` string, required

## Query parameters

- `userIdentifier` string
- `groupIdentifier` string
- `name` string, password
- `projectCategory` string
- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListProjectsOutput
  - `items` ProjectSummary[] — The results of the <code>ListProjects</code> action.
    - `domainId` string, required — The identifier of a Amazon DataZone domain where the project exists.
    - `id` string, required — The identifier of a project.
    - `name` string, password, required — The name of a project.
    - `description` string, password — The description of a project.
    - `projectStatus` 'ACTIVE' | 'DELETING' | 'DELETE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'MOVING' — The status of the project.
    - `failureReasons` ProjectDeletionError[] — Specifies the error message that is returned if the operation cannot be successfully completed.
      - `code` string — The code of the project deletion error.
      - `message` string — The message of the project deletion error.
    - `createdBy` string, required — The Amazon DataZone user who created the project.
    - `createdAt` string, date-time — The timestamp of when a project was created.
    - `updatedAt` string, date-time — The timestamp of when the project was updated.
    - `domainUnitId` string — The ID of the domain unit.
    - `projectCategory` string — The category of the project.
  - `nextToken` string — When the number of projects 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 projects, the response includes a pagination token named <code>NextToken</code>. You can specify this <code>NextToken</code> value in a subsequent call to <code>ListProjects</code> to list the next set of projects.

## 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)