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

# GET /v2/domains/{identifier}

`GET /v2/domains/{identifier}`

Gets an Amazon DataZone domain.

## Path parameters

- `identifier` string, required

## Response `200`

Success

- GetDomainOutput
  - `id` string, required — The identifier of the specified Amazon DataZone domain.
  - `rootDomainUnitId` string — The ID of the root domain in Amazon Datazone.
  - `name` string — The name of the Amazon DataZone domain.
  - `description` string — The description of the Amazon DataZone domain.
  - `singleSignOn` object — The single sing-on option of the specified Amazon DataZone domain.
    - `type` 'IAM_IDC' | 'DISABLED' — The type of single sign-on in Amazon DataZone.
    - `userAssignment` 'AUTOMATIC' | 'MANUAL' — The single sign-on user assignment in Amazon DataZone.
    - `idcInstanceArn` string — The ARN of the IDC instance.
  - `domainExecutionRole` string, required — The domain execution role with which the Amazon DataZone domain is created.
  - `arn` string — The ARN of the specified Amazon DataZone domain.
  - `kmsKeyIdentifier` string — The identifier of the Amazon Web Services Key Management Service (KMS) key that is used to encrypt the Amazon DataZone domain, metadata, and reporting data.
  - `status` 'CREATING' | 'AVAILABLE' | 'CREATION_FAILED' | 'DELETING' | 'DELETED' | 'DELETION_FAILED', required — The status of the specified Amazon DataZone domain.
  - `portalUrl` string — The URL of the data portal for this Amazon DataZone domain.
  - `createdAt` string, date-time — The timestamp of when the Amazon DataZone domain was created.
  - `lastUpdatedAt` string, date-time — The timestamp of when the Amazon DataZone domain was last updated.
  - `tags` object — The tags specified for the Amazon DataZone domain.
  - `domainVersion` 'V1' | 'V2' — The version of the domain.
  - `serviceRole` string — The service role of the domain.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ServiceQuotaExceededException
- `485` — ValidationException
- `486` — 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)