---
title: "POST /datastore/{datastoreId}/imageSet/{imageSetId}/getImageSet"
method: POST
path: "/datastore/{datastoreId}/imageSet/{imageSetId}/getImageSet"
---

# POST /datastore/{datastoreId}/imageSet/{imageSetId}/getImageSet

`POST /datastore/{datastoreId}/imageSet/{imageSetId}/getImageSet`

Get image set properties.

## Path parameters

- `datastoreId` string, required
- `imageSetId` string, required

## Query parameters

- `version` string

## Response `200`

Success

- GetImageSetResponse
  - `datastoreId` string, required — The data store identifier.
  - `imageSetId` string, required — The image set identifier.
  - `versionId` string, required — The image set version identifier.
  - `imageSetState` 'ACTIVE' | 'LOCKED' | 'DELETED', required — The image set state.
  - `imageSetWorkflowStatus` 'CREATED' | 'COPIED' | 'COPYING' | 'COPYING_WITH_READ_ONLY_ACCESS' | 'COPY_FAILED' | 'UPDATING' | 'UPDATING_FOR_STUDY_CONSISTENCY' | 'UPDATED' | 'UPDATE_FAILED' | 'DELETING' | 'DELETED' | 'IMPORTING' | 'IMPORTED' | 'IMPORT_FAILED' — The image set workflow status.
  - `createdAt` string, date-time — The timestamp when image set properties were created.
  - `updatedAt` string, date-time — The timestamp when image set properties were updated.
  - `deletedAt` string, date-time — The timestamp when the image set properties were deleted.
  - `message` string — The error message thrown if an image set action fails.
  - `imageSetArn` string — The Amazon Resource Name (ARN) assigned to the image set.
  - `overrides` object — This object contains the details of any overrides used while creating a specific image set version. If an image set was copied or updated using the <code>force</code> flag, this object will contain the <code>forced</code> flag.
    - `forced` boolean — Providing this parameter will force completion of the <code>CopyImageSet</code> and <code>UpdateImageSetMetadata</code> actions, even if metadata is inconsistent at the Patient, Study, and/or Series levels.
  - `isPrimary` boolean — The flag to determine whether the image set is primary or not.
  - `lastAccessedAt` string, date-time — When the image set was last accessed.
  - `storageTier` 'FREQUENT_ACCESS' | 'ARCHIVE_INSTANT_ACCESS' — The storage tier of the image set.

## Other responses

- `480` — ThrottlingException
- `481` — ConflictException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — InternalServerException
- `485` — ResourceNotFoundException

---

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