0.1.0 - ci-build
MADO, published by Example Publisher. 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/oijauregui/MADO-through-FHIR-Publisher/ and changes regularly. See the Directory of published versions
This is the MADO (Manifest-based Access to DICOM Objects) profile documentation, converted from the IHE Radiology Technical Framework Supplement.
The source document is "IHE_RAD Suppl_MADO_draft_0.4_Volume1.pdf" - Revision 0.4 – Draft in Preparation for Public Comment, dated August 18, 2025.
This profile is being developed by the IHE-HL7 Europe Sub-team on imaging manifest for use in the European Health Data Space (EHDS) context.
This supplement describes the Manifest-based Access to DICOM Objects (MADO) profile for the IHE Radiology Technical Framework.
The MADO profile defines mechanisms for manifest-based access to DICOM objects, enabling efficient retrieval and management of imaging studies through standardized manifest structures.
Note: This document is prepared to become a future supplement to the IHE Radiology Technical Framework. It anticipates the acceptance of a new profile proposal submitted on July 20th 2025 to the IHE Radiology 2025-2026 Cycle. It is developed by the IHE-HL7 Europe Working Group on Imaging with the goal to use this new profile in the context of the EHDS use case on the sharing of imaging studies and related imaging reports.
This supplement is intended to be a supplement to the IHE Radiology Technical Framework V22.0. Each supplement undergoes a process of public comment and trial implementation before being incorporated into the volumes of the Technical Frameworks.
For review and comment only. DO NOT implement this public comment version.
The profile structure includes:
Volume 1: Profile overview in terms of Actor/Transactions, the overall use case and associated scenarios. Volume 1 states the required and optional transactions, as well as the required/optional grouping.
Volume 2: Chapter on the WADO-RS Retrieve Transaction
Volume 3: Chapter on the Manifest content including:
This supplement is published for Public Comment. Comments are invited and must be received by the specified deadline to be considered in development of the Trial Implementation version of the supplement.
The MADO profile defines the following actors, transactions, and content modules for manifest-based access to DICOM objects.
The MADO profile includes the following actors:
The MADO profile defines the following transactions:
The profile defines content modules for:
The Content Creator actor is responsible for:
Profile Requirements: The Content Creator shall support at least one of the manifest format options (DICOM KOS or FHIR).
The Content Consumer actor is responsible for:
Profile Requirements: The Content Consumer shall be grouped with an Imaging Document Consumer for actual image retrieval.
The Imaging Document Consumer actor is responsible for:
Profile Requirements: This actor shall be grouped with a Content Consumer actor.
The Imaging Document Source actor is responsible for:
[Options to be defined based on specific implementation requirements]
The following actor groupings are required:
The MADO profile operates within intra-community sharing infrastructures to enable efficient access to imaging studies through manifest-based approaches.
The profile considers the relationship between imaging manifests and associated imaging reports, enabling comprehensive access to imaging-related information.
The profile leverages DICOMweb standards for study service retrieve operations, providing standardized URIs for accessing imaging content.
This use case describes the process of retrieving DICOM instances based on manifest information.
Actors Involved:
Basic Flow:
The MADO profile shall address the following security considerations:
The MADO profile may interact with other IHE profiles including:
Additional considerations for cross-profile interactions will be defined based on implementation requirements.
This transaction is used by the Imaging Document Consumer to retrieve DICOM instances from the Imaging Document Source using WADO-RS (Web Access to DICOM Objects - RESTful Services).
Actor | Role |
---|---|
Imaging Document Consumer | Requests DICOM instances using WADO-RS |
Imaging Document Source | Provides DICOM instances in response to WADO-RS requests |
This transaction involves the following message exchanges:
The Imaging Document Consumer triggers this message when:
The Get Instances Request follows the DICOM WADO-RS specification for instance retrieval.
HTTP Method: GET
Request URL Format:
{service}/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}
Query Parameters:
accept
: Specifies the acceptable media types for the responsetransferSyntax
: Optionally specifies the desired transfer syntaxHTTP Headers:
Accept
: Specifies acceptable content types (e.g., application/dicom
)Authorization
: Contains authentication credentials if requiredGET /wado-rs/studies/1.2.840.113619.2.55.3.604688119.971.1234567890.123/series/1.2.840.113619.2.55.3.604688119.971.1234567890.456/instances/1.2.840.113619.2.55.3.604688119.971.1234567890.789 HTTP/1.1
Host: example-pacs.hospital.org
Accept: application/dicom
Authorization: Bearer <token>
User-Agent: MADO-Client/1.0
The Imaging Document Consumer shall:
The Imaging Document Source generates this response upon receiving a valid Get Instances Request.
HTTP Status Codes:
200 OK
: Instance successfully retrieved206 Partial Content
: Partial instance content (if range requests are used)400 Bad Request
: Invalid request parameters401 Unauthorized
: Authentication required or failed403 Forbidden
: Access denied404 Not Found
: Requested instance not found500 Internal Server Error
: Server error occurredResponse Headers:
Content-Type
: application/dicom
or multipart/related
Content-Length
: Size of the response bodyETag
: Entity tag for caching supportResponse Body:
The Imaging Document Source shall:
The Imaging Document Consumer triggers this message when:
HTTP Method: GET
Request URL Format:
{service}/studies/{studyUID}/series/{seriesUID}/instances/{instanceUID}/rendered
Query Parameters:
accept
: Specifies acceptable media types (e.g., image/jpeg
, image/png
)viewport
: Specifies the viewport dimensionswindow
: Specifies window/level parametersquality
: Specifies compression quality for JPEGHTTP Headers:
Accept
: Specifies acceptable image formatsAuthorization
: Contains authentication credentials if requiredGET /wado-rs/studies/1.2.840.113619.2.55.3.604688119.971.1234567890.123/series/1.2.840.113619.2.55.3.604688119.971.1234567890.456/instances/1.2.840.113619.2.55.3.604688119.971.1234567890.789/rendered?viewport=512,512&window=350,40 HTTP/1.1
Host: example-pacs.hospital.org
Accept: image/jpeg
Authorization: Bearer <token>
User-Agent: MADO-Client/1.0
The Imaging Document Consumer shall:
The Imaging Document Source generates this response upon receiving a valid Get Rendered Instances Request.
HTTP Status Codes: Similar to Get Instances Response
Response Headers:
Content-Type
: Image media type (e.g., image/jpeg
, image/png
)Content-Length
: Size of the image dataResponse Body:
The Imaging Document Source shall:
application/dicom
and standard image formatsAll WADO-RS transactions shall be audited according to ATNA requirements:
The Imaging Document Consumer shall:
The Imaging Document Source shall:
The MADO profile defines the following namespaces:
Namespace | URI | Description |
---|---|---|
MADO | http://ihe.net/fhir/mado |
Base namespace for MADO FHIR resources |
MADO-KOS | http://ihe.net/mado/dicom/kos |
Namespace for DICOM KOS manifest definitions |
The following concept domains are defined for the MADO profile:
Concept Domain | Description | Binding |
---|---|---|
ManifestType | Types of imaging manifests | Required |
RetrievalMethod | Methods for retrieving imaging content | Extensible |
StudyPurpose | Purpose codes for imaging studies | Preferred |
Format Code | Description | MIME Type |
---|---|---|
urn:ihe:mado:kos:2025 | DICOM Key Object Selection Manifest | application/dicom |
urn:ihe:mado:fhir:2025 | FHIR-based Imaging Manifest | application/fhir+json |
Act Code | Display Name | Definition |
---|---|---|
MADO-MANIFEST | Imaging Manifest | A manifest document that references imaging studies and instances |
MADO-RETRIEVE | Manifest-based Retrieval | Retrieval of imaging content based on manifest information |
Role Code | Display Name | Definition |
---|---|---|
MANIFEST-CREATOR | Manifest Creator | System or person responsible for creating imaging manifests |
MANIFEST-CONSUMER | Manifest Consumer | System that processes and acts upon imaging manifests |
The following metadata elements support searching for imaging study manifests:
Metadata Element | Description | Type |
---|---|---|
patient-id | Patient identifier | Identifier |
study-uid | Study instance UID | Identifier |
modality | Imaging modality | CodeableConcept |
study-date | Study acquisition date | Date |
manifest-type | Type of manifest | CodeableConcept |
The MADO profile utilizes DICOM Key Object Selection (KOS) documents as one format for imaging manifests. These documents follow the DICOM Structured Report framework.
DICOM manifests shall support appropriate display mechanisms for human-readable presentation of manifest content.
Imaging Manifest: A document that contains references to one or more imaging studies, series, or instances, along with relevant metadata for retrieval and processing.
Key Object Selection (KOS): A DICOM object that identifies and describes a set of DICOM objects (studies, series, instances) for a specific purpose.
Manifest Consumer: An entity that processes imaging manifests to facilitate subsequent imaging retrieval operations.
####### 7.3.1.1.1.1 Referenced Standards
####### 7.3.1.1.1.2 IOD Definition
The Key Object Selection Document IOD for MADO purposes shall include the following modules:
IE | Module | Reference | Usage |
---|---|---|---|
Patient | Patient | C.7.1.1 | M |
Study | General Study | C.7.2.1 | M |
Series | Key Object Document Series | C.17.6.1 | M |
Equipment | General Equipment | C.7.5.1 | M |
Document | Key Object Document | C.17.6.2 | M |
Document | SR Document Content | C.17.3 | M |
Document | SOP Common | C.12.1 | M |
Legend: M = Mandatory, U = User Defined, C = Conditional
####### 7.4.1.1.1.1 Referenced Standards
####### 7.4.1.1.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Patient's Name | (0010,0010) | 2 | Patient's full name |
Patient ID | (0010,0020) | 2 | Primary identifier for the patient |
Patient's Birth Date | (0010,0030) | 2 | Patient's date of birth |
Patient's Sex | (0010,0040) | 2 | Patient's sex |
Type Legend: 1 = Required, 2 = Required if known, 3 = Optional
Additional MADO Requirements:
####### 7.4.1.2.1.1 Referenced Standards
####### 7.4.1.2.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Study Instance UID | (0020,000D) | 1 | Unique identifier for the Study |
Study Date | (0008,0020) | 2 | Date the Study started |
Study Time | (0008,0030) | 2 | Time the Study started |
Referring Physician's Name | (0008,0090) | 2 | Name of the physician referring the patient |
Study ID | (0020,0010) | 2 | User or equipment generated Study identifier |
Accession Number | (0008,0050) | 2 | RIS generated number identifying the order |
Study Description | (0008,1030) | 3 | User-defined description of the Study |
MADO Requirements:
####### 7.4.1.3.1.1 Referenced Standards
####### 7.4.1.3.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Modality | (0008,0060) | 1 | Type of equipment that originally acquired the data |
Series Instance UID | (0020,000E) | 1 | Unique identifier of the Series |
Series Number | (0020,0011) | 1 | A number that identifies this Series |
MADO Specifications:
####### 7.4.1.4.1.1 Referenced Standards
####### 7.4.1.4.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Manufacturer | (0008,0070) | 2 | Manufacturer of the equipment |
Institution Name | (0008,0080) | 3 | Institution where equipment is located |
Software Versions | (0018,1020) | 3 | Manufacturer's software versions |
MADO Requirements:
####### 7.4.1.5.1.1 Referenced Standards
####### 7.4.1.5.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Instance Number | (0020,0013) | 1 | A number that identifies this KO Document |
Content Date | (0008,0023) | 1 | Date the document content creation |
Content Time | (0008,0033) | 1 | Time the document content creation |
Referenced Request Sequence | (0040,A370) | 1C | Sequence of Items referencing requests |
Current Requested Procedure Evidence Sequence | (0040,A375) | 1 | Evidence sequence for current procedure |
Current Requested Procedure Evidence Sequence Items:
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Study Instance UID | (0020,000D) | 1 | UID of the referenced Study |
Referenced Series Sequence | (0008,1115) | 1 | Sequence of referenced Series |
Referenced Series Sequence Items:
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Series Instance UID | (0020,000E) | 1 | UID of the referenced Series |
Referenced SOP Sequence | (0008,1140) | 1C | Sequence of referenced SOP Instances |
Referenced SOP Sequence Items:
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Referenced SOP Class UID | (0008,1150) | 1 | SOP Class UID of referenced object |
Referenced SOP Instance UID | (0008,1155) | 1 | SOP Instance UID of referenced object |
MADO Specifications:
####### 7.4.1.6.1.1 Referenced Standards
####### 7.4.1.6.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
Value Type | (0040,A040) | 1 | Type of value stored in this content item |
Concept Name Code Sequence | (0040,A043) | 1 | Coded concept name of this content item |
Content Sequence | (0040,A730) | 1C | Sequence of content items |
MADO Content Structure:
####### 7.4.1.7.1.1 Referenced Standards
####### 7.4.1.7.1.2 Module Definition
Attribute Name | Tag | Type | Attribute Description |
---|---|---|---|
SOP Class UID | (0008,0016) | 1 | Uniquely identifies the SOP Class |
SOP Instance UID | (0008,0018) | 1 | Uniquely identifies the SOP Instance |
Specific Character Set | (0008,0005) | 1C | Character set used for text values |
Instance Creation Date | (0008,0012) | 3 | Date the SOP Instance was created |
Instance Creation Time | (0008,0013) | 3 | Time the SOP Instance was created |
MADO Requirements:
The MADO profile supports FHIR-based manifests using the following resource types:
The ImagingStudy resource is used to represent imaging studies referenced in FHIR-based manifests.
Key Elements:
identifier
: Study identifiers including Study Instance UIDstatus
: Status of the imaging studysubject
: Reference to the Patientencounter
: Reference to the encounter contextstarted
: Date/time when study was startedseries
: Series within the studyendpoint
: DICOM endpoints for retrievalThe List resource serves as the primary manifest container for FHIR-based implementations.
Key Elements:
status
: Status of the manifest listmode
: Mode of the list (typically "working")title
: Human-readable title for the manifestcode
: Code identifying this as an imaging manifestsubject
: Reference to the Patientdate
: Date the manifest was createdsource
: Creator of the manifestentry
: References to ImagingStudy resourcesThe Endpoint resource defines DICOM endpoints for image retrieval.
Key Elements:
status
: Endpoint statusconnectionType
: Type of connection (e.g., DICOM WADO-RS)address
: Base URL for the endpointpayloadType
: Supported payload typesThis section defines the mapping between DICOM KOS-based manifests and FHIR-based manifests to enable interoperability between the two formats.
DICOM Element | FHIR Element | Mapping Notes |
---|---|---|
Patient ID (0010,0020) | Patient.identifier | Direct mapping |
Study Instance UID (0020,000D) | ImagingStudy.identifier | Use DICOM UID format |
Series Instance UID (0020,000E) | ImagingStudy.series.uid | Direct mapping |
SOP Instance UID (0008,0018) | ImagingStudy.series.instance.uid | Direct mapping |
Study Date (0008,0020) | ImagingStudy.started | Convert to FHIR dateTime |
Referring Physician (0008,0090) | ImagingStudy.referrer | Map to Practitioner reference |
FHIR Element | DICOM Element | Mapping Notes |
---|---|---|
Patient.identifier | Patient ID (0010,0020) | Use primary identifier |
ImagingStudy.identifier | Study Instance UID (0020,000D) | Extract DICOM UID |
ImagingStudy.series.uid | Series Instance UID (0020,000E) | Direct mapping |
ImagingStudy.series.instance.uid | SOP Instance UID (0008,0018) | Direct mapping |
ImagingStudy.started | Study Date/Time (0008,0020/0030) | Convert from FHIR dateTime |
The following example shows the structure of a DICOM Key Object Selection document used as an imaging manifest in the MADO profile:
Key Object Selection Document
├── Patient Module
│ ├── Patient's Name: "DOE^JOHN"
│ ├── Patient ID: "12345"
│ ├── Patient's Birth Date: "19800101"
│ └── Patient's Sex: "M"
├── General Study Module
│ ├── Study Instance UID: "1.2.840.113619.2.55.3.604688119.971.1234567890.123"
│ ├── Study Date: "20250819"
│ ├── Study Time: "143000"
│ └── Accession Number: "ACC12345"
├── Key Object Document Series Module
│ ├── Modality: "KO"
│ ├── Series Instance UID: "1.2.840.113619.2.55.3.604688119.971.1234567890.456"
│ └── Series Number: "1"
├── Key Object Document Module
│ └── Current Requested Procedure Evidence Sequence
│ └── Study Instance UID: "1.2.840.113619.2.55.3.604688119.971.1234567890.123"
│ └── Referenced Series Sequence
│ ├── Series Instance UID: "1.2.840.113619.2.55.3.604688119.971.1234567890.789"
│ └── Referenced SOP Sequence
│ ├── Referenced SOP Class UID: "1.2.840.10008.5.1.4.1.1.2"
│ └── Referenced SOP Instance UID: "1.2.840.113619.2.55.3.604688119.971.1234567890.101"
└── SR Document Content Module
└── Content Item: "MADO Manifest for Emergency Review"
{
"resourceType": "List",
"id": "mado-manifest-example",
"meta": {
"profile": [
"http://ihe.net/fhir/mado/StructureDefinition/ImagingManifestList"
]
},
"status": "current",
"mode": "working",
"title": "Emergency Imaging Review Manifest",
"code": {
"coding": [
{
"system": "http://ihe.net/fhir/mado",
"code": "imaging-manifest",
"display": "Imaging Manifest"
}
]
},
"subject": {
"reference": "Patient/patient-example"
},
"date": "2025-08-19T14:30:00Z",
"source": {
"reference": "Device/manifest-creator"
},
"entry": [
{
"item": {
"reference": "ImagingStudy/chest-ct-study"
}
}
]
}
Associated ImagingStudy Resource:
{
"resourceType": "ImagingStudy",
"id": "chest-ct-study",
"identifier": [
{
"use": "official",
"system": "urn:dicom:uid",
"value": "urn:oid:1.2.840.113619.2.55.3.604688119.971.1234567890.123"
}
],
"status": "available",
"subject": {
"reference": "Patient/patient-example"
},
"started": "2025-08-19T10:00:00Z",
"numberOfSeries": 1,
"numberOfInstances": 150,
"series": [
{
"uid": "1.2.840.113619.2.55.3.604688119.971.1234567890.789",
"modality": {
"system": "http://dicom.nema.org/resources/ontology/DCM",
"code": "CT"
},
"numberOfInstances": 150,
"endpoint": [
{
"reference": "Endpoint/wado-rs-endpoint"
}
]
}
]
}
The MADO profile supports the following authentication methods:
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Client certificates may be used for mutual TLS authentication in high-security environments.
Access decisions based on:
All MADO transactions shall generate audit events including:
{
"resourceType": "AuditEvent",
"type": {
"system": "http://dicom.nema.org/resources/ontology/DCM",
"code": "110100",
"display": "Application Activity"
},
"action": "R",
"recorded": "2025-08-19T14:30:00Z",
"outcome": "0",
"agent": [
{
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/extra-security-role-type",
"code": "humanuser"
}
]
},
"who": {
"identifier": {
"value": "radiologist@hospital.org"
}
}
}
],
"source": {
"site": "MADO-System",
"identifier": {
"value": "urn:oid:1.2.3.4.5.6.7.8.9.10"
}
},
"entity": [
{
"what": {
"identifier": {
"value": "1.2.840.113619.2.55.3.604688119.971.1234567890.123"
}
},
"type": {
"system": "http://terminology.hl7.org/CodeSystem/audit-entity-type",
"code": "2",
"display": "System Object"
},
"role": {
"system": "http://terminology.hl7.org/CodeSystem/object-role",
"code": "1",
"display": "Patient"
}
}
]
}
Error Type | HTTP Status | Description | Mitigation |
---|---|---|---|
Invalid Manifest | 400 | Malformed manifest structure | Validate manifest before processing |
Missing Study | 404 | Referenced study not found | Check study availability |
Access Denied | 403 | Insufficient permissions | Verify user authorization |
Server Error | 500 | Internal processing error | Implement retry logic |
{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "error",
"code": "not-found",
"details": {
"text": "Referenced study 1.2.3.4.5 not found"
},
"location": [
"ImagingStudy.identifier"
]
}
]
}
Systems implementing MADO shall support:
Scenario: A clinical decision support system needs to retrieve relevant prior imaging studies for comparison with current studies.
Flow:
Scenario: A radiologist needs to review cases from multiple imaging sites for a tumor board meeting.
Flow:
Scenario: Researchers need to collect imaging data matching specific criteria for a study.
Flow:
Scenario: Emergency department needs immediate access to patient's recent imaging studies.
Flow:
DICOM: Digital Imaging and Communications in Medicine - Standard for medical imaging information
FHIR: Fast Healthcare Interoperability Resources - HL7 standard for health information exchange
ImagingStudy: FHIR resource representing a collection of imaging series
Key Object Selection (KOS): DICOM object that references other DICOM objects for a specific purpose
List: FHIR resource that represents a collection of other resources
Manifest: Document containing references to imaging studies or instances
WADO-RS: Web Access to DICOM Objects - RESTful Services for accessing DICOM content
Endpoint: FHIR resource representing a network service for accessing resources