SMART Imaging Access
0.1.0 - ci-build
SMART Imaging Access, published by Argonaut Project. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/argonautproject/smart-imaging/ and changes regularly. See the Directory of published versions
This page is non-normative. If you come from the FHIR world and DICOM identifiers are new to you (or vice versa), this page explains the systems involved in hospital imaging, the identifiers each one mints, and how those identifiers tie the EHR's view of a study to the imaging system's view.
Five identifiers do almost all the work in imaging integrations:
| Identifier | Minted by | What it names |
|---|---|---|
| MRN | EHR | The patient, within one organization |
| Accession Number | RIS | The imaging order |
| Study Instance UID | Imaging modality/PACS | One DICOM study |
| Series Instance UID | Imaging modality/PACS | One series within a study |
| SOP Instance UID | Imaging modality/PACS | One instance (e.g., one slice) within a series |
A simplified view of hospital imaging (inspired by the IHE Radiology profiles, with worklist details omitted):
ServiceRequest.DiagnosticReport (and/or DocumentReference), ideally also carrying the Study Instance UID.Three systems hold three views of the same study. The shared identifiers are what let an app (or an Imaging Server) walk between them:
ImagingStudy mirrors the DICOM hierarchy: the Study Instance UID as its identifier, series and instance UIDs within, a reference to the Patient (MRN), optionally a basedOn reference carrying the Accession Number, and endpoint references pointing at WADO-RS.ServiceRequest carries the Accession Number and the DiagnosticReport should reference the study by Study Instance UID — an identifier reference, not necessarily a resolvable URL.That last point is deliberate: the EHR and the Imaging Server stay loosely coupled. The EHR doesn't need to know the Imaging Server's URLs; it just records identifiers. An app that finds a DiagnosticReport with a Study Instance UID can search the Imaging Server with patient={id}&identifier=urn:oid:{uid} and get the actual study — which is exactly why Finding studies requires that search combination. And the Imaging Server, handed a token for Patient/123, can fetch that Patient from the EHR to learn the MRN it needs to query its own PACS — which is why Authorization mentions Backend Services access.
How EHRs should represent imaging reports in FHIR is ultimately jurisdictional guidance territory (for example, US Core); the model above reflects the direction of early consensus.