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
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