HL7 Europe Imaging Report R5
0.1.1-build - ci-build 150

HL7 Europe Imaging Report R5, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 0.1.1-build built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/imaging-r5/ and changes regularly. See the Directory of published versions

CapabilityStatement: EEHRxF Imaging Report Resource Access Provider CapabilityStatement

Official URL: http://hl7.eu/fhir/imaging-r5/CapabilityStatement/EeehrxfImagingReportResourceAccessProvider Version: 0.1.1-build
Computable Name: EEHRxFResourceAccessProvider

Copyright/Legal: Copyright HL7 Europe. Licensed under Creative Commons public domain (CC0 1.0).

CapabilityStatement for the EEHRxF Imaging Report Resource Access Provider actor. This actor serves clinical data resources following the International Patient Access (IPA) patterns and IHE QEDm Clinical Data Source capabilities.

This CapabilityStatement defines the capabilities for systems providing direct resource access (beyond document-based exchange) in the EU EHR Exchange Format (EEHRxF) ecosystem. It inherits patterns from:

  • IPA (International Patient Access): Resource profiles and search parameter patterns
  • IHE QEDm (Query for Existing Data for Mobile): Clinical Data Source actor capabilities

Resource Flexibility (IPA Alignment)

Following IPA's approach, servers are not required to support all clinical resources listed below. Servers MAY choose which resources to implement based on their capabilities and use cases. The only required resource is Patient (for lookup context). This flexibility encourages partial implementations, allowing more servers to participate even if they only support EU Core for certain resource types.

Required: Patient (for lookup context) Recommended (choose based on capabilities):

  • Practitioner, Organization: Reference resolution
  • Condition, AllergyIntolerance: Patient safety data
  • Observation, DiagnosticReport: Clinical results
  • MedicationRequest, MedicationDispense: Medication data
  • Encounter: Visit context

The server's CapabilityStatement declares which resources are actually supported.

Security

Systems SHALL support SMART Backend Services authorization for all transactions.

Profile Inheritance

Resources SHOULD conform to EU Core profiles where available.

Raw OpenAPI-Swagger Definition file | Download

Language: en

EEHRxF Imaging Report Resource Access Provider CapabilityStatement

  • Implementation Guide Version: 0.1.1-build
  • FHIR Version: 4.0.1
  • Supported Formats: json, xml
  • Published on: 2026-02-02
  • Published by: HL7 Europe

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

This CapabilityStatement instantiates the CapabilityStatement International Patient Access Server CapabilityStatement

FHIR RESTful Capabilities

Mode: server

The Imaging Report Resource Access Provider actor responds to queries for clinical data resources following IPA and QEDm patterns. This enables direct resource access complementing document-based exchange via MHD.

All transactions require SMART Backend Services authorization.

Security
Enable CORS: no
Security services supported: SMART-on-FHIR

SMART Backend Services authorization is REQUIRED for all transactions. Systems SHALL:

  • Validate JWT client credentials (RFC 7523)
  • Verify appropriate scopes for resource access
  • Use TLS 1.2 or higher for all communications
  • Return HTTP 401, 403, or 404 for unauthorized requests

Resource Flexibility

Following IPA's approach, servers MAY choose which clinical resources to support based on their capabilities and use cases. Patient is required for lookup context; other resources are recommended but servers may implement a subset. The server's CapabilityStatement declares which resources are actually supported.

Scopes for Supported Resources

Servers SHALL accept scopes for the resources they support:

  • system/AdverseEvent.read, system/AdverseEvent.search
  • system/Patient.read, system/Patient.search
  • system/Condition.read, system/Condition.search (if Condition supported)
  • system/AllergyIntolerance.read, system/AllergyIntolerance.search (if AllergyIntolerance supported)
  • system/Observation.read, system/Observation.search
  • system/Composition.read, system/Observation.search
  • system/DiagnosticReport.read, system/DiagnosticReport.search
  • system/MedicationRequest.read, system/MedicationRequest.search
  • system/MedicationDispense.read, system/MedicationDispense.search
  • system/Encounter.read, system/Encounter.search (if Encounter supported)
  • system/Practitioner.read (if Practitioner supported)
  • system/Organization.read (if Organization supported)
  • system/Procedure.read
  • system/Provenance.read

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
Patient YY_id, identifier, family, given, birthdate
Practitioner Y
Organization Y
Condition YYpatient, clinical-status, category, code
AllergyIntolerance YYpatient, clinical-status
Observation YYpatient, category, code, date, status
DiagnosticReport YYpatient, category, code, date, status
MedicationRequest YYpatient, status, intent, authoredon
MedicationDispense YYpatient, status, whenhandedover
Encounter YYpatient, date, status, class
ImagingStudy YYbased-on, body-site, dicom-class, modality, identifier, instance, patient, performer, reason, referrer, series, started, subject, status
Device Y
Composition Y
Procedure Ypatient, subject
ServiceRequest Yidentifier, patient, subject
AdverseEvent Y
Provenance Ypatient, subject, target
ImagingSelection Y

Core FHIR Resource
Patient
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Patient by logical ID

    search-type

    Search for patients for lookup purposes

Documentation

Patient resources support patient lookup per PDQm [ITI-78] with identifier as a required search parameter. Note: Patient is used for lookup context, not as a primary clinical data resource in this actor.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Patient logical ID

SHALLidentifiertoken

Patient identifier (e.g., national ID, MRN) - required for patient lookup

SHOULDfamilystring

Patient family name

SHOULDgivenstring

Patient given name

SHOULDbirthdatedate

Patient date of birth

 
Core FHIR Resource
Practitioner
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Practitioner by logical ID

Documentation

Practitioner resources provide clinical context for referenced healthcare providers. Read-only access supports resolving practitioner references in clinical resources. Servers SHOULD support this resource but MAY omit it based on their capabilities.

Core FHIR Resource
Organization
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Organization by logical ID

Documentation

Organization resources provide context for referenced healthcare organizations. Read-only access supports resolving organization references in clinical resources. Servers SHOULD support this resource but MAY omit it based on their capabilities.

Core FHIR Resource
Condition
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Condition by logical ID

    search-type

    Search for Condition resources

Documentation

Condition resources represent problems, diagnoses, and health concerns. If supported, servers SHALL support search by patient and SHOULD support additional filters. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient who has the condition (SHALL support)

SHOULDclinical-statustoken

The clinical status of the condition

SHOULDcategorytoken

The category of condition

SHOULDcodetoken

Code for the condition

 
Core FHIR Resource
AllergyIntolerance
Reference Policy
Interaction summary
  • SHALL support
    read

    Read AllergyIntolerance by logical ID

    search-type

    Search for AllergyIntolerance resources

Documentation

AllergyIntolerance resources represent patient allergies and intolerances. If supported, servers SHALL support search by patient. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient who has the allergy or intolerance (SHALL support)

SHOULDclinical-statustoken

The clinical status of the allergy or intolerance

 
Core FHIR Resource
Observation
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Observation by logical ID

    search-type

    Search for Observation resources

Documentation

Observation resources represent clinical observations including vital signs, laboratory results, and other measurements. If supported, servers SHALL support search by patient and category. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient the observation is about (SHALL support)

SHALLcategorytoken

Category of observation (e.g., vital-signs, laboratory)

SHOULDcodetoken

The code of the observation type

SHOULDdatedate

Obtained date/time. Date modifiers ge, le, gt, lt SHOULD be supported.

SHOULDstatustoken

The status of the observation

 
Core FHIR Resource
DiagnosticReport
Reference Policy
Interaction summary
  • SHALL support
    read

    Read DiagnosticReport by logical ID

    search-type

    Search for DiagnosticReport resources

Documentation

DiagnosticReport resources represent laboratory results and imaging reports. If supported, servers SHALL support search by patient and category. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient the report is about (SHALL support)

SHALLcategorytoken

Category of report (e.g., LAB, RAD)

SHOULDcodetoken

The code for the report type

SHOULDdatedate

The clinically relevant time of the report

SHOULDstatustoken

The status of the report

 
Core FHIR Resource
MedicationRequest
Reference Policy
Interaction summary
  • SHALL support
    read

    Read MedicationRequest by logical ID

    search-type

    Search for MedicationRequest resources

Documentation

MedicationRequest resources represent medication orders and prescriptions. If supported, servers SHALL support search by patient. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient for whom the medication was ordered (SHALL support)

SHOULDstatustoken

Status of the prescription

SHOULDintenttoken

The intent of the medication request

SHOULDauthoredondate

Return prescriptions written on this date

 
Core FHIR Resource
MedicationDispense
Reference Policy
Interaction summary
  • SHALL support
    read

    Read MedicationDispense by logical ID

    search-type

    Search for MedicationDispense resources

Documentation

MedicationDispense resources represent medication dispensing events. If supported, servers SHALL support search by patient. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient for whom the medication was dispensed (SHALL support)

SHOULDstatustoken

Status of the dispense

SHOULDwhenhandedoverdate

When the medication was handed over

 
Core FHIR Resource
Encounter
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Encounter by logical ID

    search-type

    Search for Encounter resources

Documentation

Encounter resources represent patient encounters (visits, admissions, etc.). If supported, servers SHALL support search by patient. Servers MAY omit this resource based on their capabilities.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient present at the encounter (SHALL support)

SHOULDdatedate

A date within the encounter period

SHOULDstatustoken

Status of the encounter

SHOULDclasstoken

Classification of the encounter (e.g., inpatient, outpatient)

 
Core FHIR Resource
ImagingStudy
Reference Policy
Interaction summary
  • SHALL support
    read

    Read ImagingStudy by logical ID

    search-type

    Search for ImagingStudy resources.

Documentation

ImagingStudy resources represent a summary of an imaging exam as represented in DICOM.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLbased-onreference

The order that lead to the imaging study.

SHALLbody-sitetoken

The body-site the study examined.

SHALLmodalitytoken

The modality of the imaging study.

SHALLidentifiertoken

The identifier of the imaging study.

SHALLpatientreference

The patient the study is about.

SHALLstarteddate

The date the study was started.

SHALLsubjectreference

The status of the study.

SHALLstatustoken

The subject the study is about.

SHOULDdicom-classtoken

The type of the instances.

SHOULDinstancetoken

The SOP Instance UID of the instances in the imaging study.

SHOULDperformerreference

The person who performed the study.

SHOULDreasontoken

The reason the study was performed.

SHOULDreferrerreference

The referring physician.

SHOULDseriestoken

The the UID of a series in the study.

 
Core FHIR Resource
Device
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Device by logical ID

Documentation

Represents a Device. No search has been defined as all compositions should be accessed from a reference. When a server does not support it, the resource is to be included as a contained resource.

Core FHIR Resource
Composition
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Composition by logical ID

Documentation

Represents a rendering of a report. No search has been defined as all compositions should be accessed from the DiagnosticReport.

Core FHIR Resource
Procedure
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Procedure by logical ID

Documentation

Represents the procedure that generated the study.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient of the procedure.

SHALLsubjectreference

The subject of the procedure.

 
Core FHIR Resource
ServiceRequest
Reference Policy
Interaction summary
  • SHALL support
    read

    Read ServiceRequest by logical ID

Documentation

Represents the order that generated the study.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken

The identifier of the order (accession number).

SHALLpatientreference

The patient of the order.

SHALLsubjectreference

The subject of the order.

 
Core FHIR Resource
AdverseEvent
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Composition by logical ID

Documentation

Represents an adverse event that occurred during the imaging procedure.

Core FHIR Resource
Provenance
Reference Policy
Interaction summary
  • SHALL support
    read

    Read ServiceRequest by logical ID

Documentation

Represents the provenance of the report.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

The patient of the order.

SHALLsubjectreference

The subject of the order.

SHALLtargetreference

The target of the provenance.

 
Core FHIR Resource
ImagingSelection
Reference Policy
Interaction summary
  • SHALL support
    read

    Read Composition by logical ID

Documentation

Represents part of an imaging study.