Searching for a study's DICOM instances in HealthImaging

Use the SearchDICOMStudyInstances API to search for all DICOM instances within a study in an HealthImaging data store. Construct a request URL with supported DICOM data elements (attributes) to filter results. The API returns instance search results in JSON format, ordered by last update date, descending (latest to oldest).

To search for a study's DICOM instances

Collect HealthImaging region and datastoreId values. For more information, see Getting data store properties.
Collect the StudyInstanceUID value. For more information, see Getting image set metadata.

Construct a URL for the request, including all applicable search elements. The URL is of the form:


GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastoreId/studies/StudyInstanceUID/instances[?query]

The following table lists the supported DICOM data elements (attributes).

Instance elements for `SearchDICOMStudyInstances`
DICOM element tag	DICOM element name
`(0008,0020)`	`Study Date`
`(0008,0030)`	`Study Time`
`(0008,0050)`	`Accession Number`
`(0008,0061)`	`Modalities in Study`
`(0008,0060)`	`Modality`
`(0008,0090)`	`Referring Physician Name`
`(0008,1030)`	`Study Description`
`(0010,0010)`	`Patient Name`
`(0010,0020)`	`Patient ID`
`(0010,0030)`	`Patient BirthDate`
`(0010,0032)`	`Patient BirthTime`
`(0020,000D)`	`Study Instance UID`
`(0020,0010)`	`Study ID`
`(0020,000E)`	`Series Instance UID`
`(0020,0011)`	`Series Number`
`(0040,0244)`	`Performed Procedure Step Start Date`
`(0040,0245)`	`Performed Procedure Step Start Time`
`(0008,0016)`	`SOP Class UID`
`(0008,0018)`	`SOP Instance UID`

Prepare and send your request. SearchDICOMStudyInstances uses an HTTP GET request signed with AWS Signature Version 4. The following example uses the curl command-line tool. Replace region with your AWS Region. Replace datastoreId with your data store ID. Replace StudyInstanceUID with the study's UID.

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Search for instances

Search for all series