ImagingStudy Resource

The FHIR ImagingStudy resource represents a medical imaging study and describes the DICOM content associated with the examination. It provides study-level information such as the accession number, Study Instance UID, modality, status, series, and individual instances.

Within AdvaPACS, ImagingStudy can be used to retrieve information about imaging studies stored in the PACS. The resource describes the structure and identifiers of the study but does not contain the image data itself. Imaging content can instead be accessed using the corresponding DICOM services. For full information on the ImagingStudy resource, please refer to the FHIR standard.

Supported Transactions

AdvaPACS supports the following transactions for the ImagingStudy resource:

Function	Method	Endpoint	Description
Get ImagingStudy	GET	/ImagingStudy/{id}	Retrieves a specific ImagingStudy resource by its logical ID.
Search ImagingStudies	GET	/ImagingStudy	Searches for ImagingStudy resources using supported search parameters.

Examples

The following examples show how to retrieve and search for ImagingStudy resources using the AdvaPACS FHIR API. These examples are intended to help you understand how imaging study information is represented within FHIR and how studies can be located using common identifiers and search parameters.

Get an ImagingStudy

Retrieve a specific ImagingStudy resource using its logical FHIR resource ID. The response contains information about the imaging study stored in AdvaPACS, including its identifiers, patient reference, status, modalities, series, and associated DICOM instances.

For example, to retrieve the ImagingStudy with the resource ID 123456.

GET /ImagingStudy/123456
Authorization: ID=<ApiId>,Secret=<ApiSecret>
Accept: application/fhir+json
Host: <FhirEndpoint>

A successful request returns the requested ImagingStudy resource.

{
  "resourceType": "ImagingStudy",
  "id": "123456",
  "status": "available",
  "subject": {
    "reference": "Patient/789012"
  },
  "identifier": [
    {
      "system": "urn:dicom:uid",
      "value": "urn:oid:1.2.840.113619.2.55.3.604688123.1234.1599751234.467"
    }
  ],
  "numberOfSeries": 1,
  "numberOfInstances": 10
}

Note

The ImagingStudy resource provides metadata describing the study and its contents. It does not include the DICOM image data itself.

Search ImagingStudies

Search for one or more ImagingStudy resources using standard FHIR search parameters. You can search using one or more supported parameters, and multiple parameters may be combined to further refine the results. The following search parameters are supported by the AdvaPACS ImagingStudy resource.

Parameter	Type	Description
patient	reference	Search for imaging studies associated with a specific Patient.
identifier	token	Search using a study identifier, such as an accession number or Study Instance UID.
basedon	reference	Search for imaging studies associated with a specific ServiceRequest.
study	token	Search using the DICOM Study Instance UID.

For example, search for imaging studies belonging to the Patient with the resource ID 1001.

GET /ImagingStudy?patient=1001
Authorization: ID=<ApiId>,Secret=<ApiSecret>
Accept: application/fhir+json
Host: <FhirEndpoint>

FHIR search operations return a FHIR Bundle containing the matching ImagingStudy resources. Each matching resource is included as an entry within the Bundle.

{
  "resourceType": "Bundle",
  "id": "12345678-9012-3456-7890-123456789012",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "resource": {
        "resourceType": "ImagingStudy",
        "id": "12345",
        "status": "available",
        "subject": {
          "reference": "Patient/1001"
        },
        "started": "2026-05-20T10:15:00Z",
        "numberOfSeries": 2,
        "numberOfInstances": 450,
        "description": "CT Chest",
        "modality": [
          {
            "system": "http://dicom.nema.org/resources/ontology/DCM",
            "code": "CT",
            "display": "Computed Tomography"
          }
        ]
      }
    }
  ]
}