Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account

Getting a DICOM instance from HealthImaging

PDF
RSS
Focus mode
Getting a DICOM instance from HealthImaging - AWS HealthImaging

Use the GetDICOMInstance action to retrieve a DICOM instance (.dcm file) from a HealthImaging data store by specifying the Series, Study, and Instance UIDs associated with the resource. You can specify the image set from which an instance resource should be retrieved by providing the image set ID as a query parameter. DICOM data can be retrieved in either its stored transfer syntax or as uncompressed (ELE) format.

To get a DICOM instance (.dcm)

  1. Collect HealthImaging datastoreId and imageSetId parameter values.

  2. Use the GetImageSetMetadata action with the datastoreId and imageSetId parameter values to retrieve associated metadata values for studyInstanceUID, seriesInstanceUID, and sopInstanceUID. For more information, see Getting image set metadata.

  3. Construct a URL for the request using the values for datastoreId, studyInstanceUID, seriesInstanceUID, sopInstanceUID, and imageSetId. To view the entire URL path in the following example, scroll over the Copy button. The URL is of the form:

    GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid?imageSetId=image-set-id

  4. Prepare and send your request. GetDICOMInstance uses a HTTP GET request with AWS Signature Version 4 signing protocol. The following code example uses the curl command line tool to get a DICOM instance (.dcm file) from HealthImaging.

    Shell
    curl --request GET \
  'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457?imageSetId=459e50687f121185f747b67bb60d1bc8' \
  --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/dicom; transfer-syntax=1.2.840.10008.1.2.1' \
  --output 'dicom-instance.dcm'
    anchor
    curl --request GET \
  'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457?imageSetId=459e50687f121185f747b67bb60d1bc8' \
  --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/dicom; transfer-syntax=1.2.840.10008.1.2.1' \
  --output 'dicom-instance.dcm'
    Note

    The transfer-syntax UID is optional and defaults to Explicit VR Little Endian if not included. Supported transfer syntaxes include:

    • Explicit VR Little Endian (ELE) - 1.2.840.10008.1.2.1 (default)

    • High-Throughput JPEG 2000 with RPCL Options Image Compression (Lossless Only) - 1.2.840.10008.1.2.4.202 - if the instance is stored in HealthImaging as 1.2.840.10008.1.2.4.202

    • JPEG Baseline (Process 1): Default Transfer Syntax for Lossy JPEG 8-bit Image Compression - 1.2.840.10008.1.2.4.50 - if the instance is stored in HealthImaging as 1.2.840.10008.1.2.4.50

    • JPEG 2000 Image Compression - 1.2.840.10008.1.2.4.91 - if the instance is stored in HealthImaging as 1.2.840.10008.1.2.4.91

    • High-Throughput JPEG 2000 Image Compression - 1.2.840.10008.1.2.4.203 - if the instance is stored in HealthImaging as 1.2.840.10008.1.2.4.203

    For more information, see Supported transfer syntaxes and HTJ2K decoding libraries for AWS HealthImaging.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.