Mobile access to Health Documents (MHD)
4.2.3 - Trial-Implementation

Mobile access to Health Documents (MHD), published by IHE IT Infrastructure Technical Committee. This guide is not an authorized publication; it is the continuous build for version 4.2.3 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/ITI.MHD/ and changes regularly. See the Directory of published versions

## CapabilityStatement: Document Consumer (client)

Official URL: https://profiles.ihe.net/ITI/MHD/CapabilityStatement/IHE.MHD.DocumentConsumer | Version: 4.2.3
Active as of 2025-10-30 | Computable Name: IHE_MHD_DocumentConsumer

IHE ITI Mobile access to Health Documents (MHD) - Document Consumer (client).

This is the Requirements CapabilityStatement for a Document Consumer. The Document Consumer may declared the UnContained References Options. This Actor is allowed to use Find Document List ITI-66, Find Document References ITI-67, and Retrieve Document ITI-68 transactions. The Document Consumer Actor should be robust for unconstrained DocumentReference and List Resources, as the results returned to the Document Consumer from the Document Responder may not follow the conformance constraints.

Figure: Query Actors Interactions

Raw OpenAPI-Swagger Definition file | Download

## Document Consumer (client)

- Implementation Guide Version: 4.2.3
- FHIR Version: 4.0.1
- Supported Formats: `application/fhir+xml`, `application/fhir+json`
- Published on: 2025-10-30 16:21:31+0000
- Published by: IHE IT Infrastructure Technical Committee

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

## FHIR RESTful Capabilities

### Mode: `client`

Security

> Recommend ATNA, encouraged IHE-IUA or SMART-on-FHIR

Summary of System-wide Interactions

- Supports the `search-system`interaction.

### 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 Type | Profile | R | S | U | C | Searches | `_include` | `_revinclude` | Operations
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
DocumentReference | https://profiles.ihe.net/ITI/MHD/StructureDefinition/IHE.MHD.Minimal.DocumentReference | y | y |  |  | _id, _lastupdated, author.given, author.family, category, creation, date, event, facility, format, identifier, patient, patient.identifier, period, related, security-label, setting, status, type |  |  |
List | https://profiles.ihe.net/ITI/MHD/StructureDefinition/IHE.MHD.List | y | y |  |  | _id, _lastupdated, code, date, identifier, patient, patient.identifier, source.given, source.family, status, designationType, sourceId |  |  |
Binary |  | y |  |  |  |  |  |  |

#### Resource Conformance: supported DocumentReference

Base System Profile
MHD DocumentReference Minimal
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Logical id of this artifact
SHALL | _lastupdated | `date` | When the resource version last changed
SHALL | author.given | `string` | These parameters, of type string, specify the name parts of the author person, which is associated with the DocumentReference Resource, or in Document Sharing nomenclature, the author of the Document Entry. See ITI TF-2x: Appendix Z.2 for use of the string data type.
SHALL | author.family | `string` | These parameters, of type string, specify the name parts of the author person, which is associated with the DocumentReference Resource, or in Document Sharing nomenclature, the author of the Document Entry. See ITI TF-2x: Appendix Z.2 for use of the string data type.
SHALL | category | `token` | Categorization of document
SHALL | creation | `date` | When this document was created
SHALL | date | `date` | When this document reference was created
SHALL | event | `token` | Main clinical acts documented
SHALL | facility | `token` | Kind of facility where patient was seen
SHALL | format | `token` | Format/content rules for the document
SHALL | identifier | `token` | The identifier for this DocumentReference
SHALL | patient | `reference` | Who/what is the subject of the document
SHALL | patient.identifier | `token` | An Identifier for Who/what is the subject of the document
SHALL | period | `date` | Time of service that is being documented
SHALL | related | `reference` | Related Resource
SHALL | security-label | `token` | Document security-tags
SHALL | setting | `token` | Additional details about where the content was created (e.g. clinical specialty)
SHALL | status | `token` | current | superseded | entered-in-error
SHALL | type | `reference` | Kind of document (LOINC if possible)

#### Resource Conformance: supported List

Base System Profile
MHD common List with designationType
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Logical id of this artifact
SHALL | _lastupdated | `date` | When the resource version last changed
SHALL | code | `token` | This parameter, of type token, specifies the code.coding value supplied in the List Resource. The value of the code element indicates the List of type SubmissionSet or Folder as indicated.
SHALL | date | `date` | This parameter, of type date, specifies the time when the List was created.
SHALL | identifier | `token` | This parameter, of type token, specifies an identifier for this List. The search results represent the results of a search on List.identifier. See ITI TF-2x: Appendix Z.2 for additional constraints on the use of the token search parameter type.
SHALL | patient | `reference` | This parameter is of type Reference(Patient). The Document Consumer may get this reference through the use of the PDQm or PIXm Profiles, or by some other method. When the patient parameter is used, the Patient reference would need to be accessible to both the Document Consumer and the Document Responder.
SHALL | patient.identifier | `token` | An Identifier for Who/what is the subject of the document
SHALL | source.given | `string` | These parameters, of type string, specify the name parts of the author person which is associated with the List. See ITI TF-2x: Appendix Z.2 for use of the string data type.
SHALL | source.family | `string` | These parameters, of type string, specify the name parts of the author person which is associated with the List. See ITI TF-2x: Appendix Z.2 for use of the string data type.
SHALL | status | `token` | This parameter, of type token, specifies the status of the List. If included in the query, the Document Consumer shall populate the code portion of the token with one of the codes in the following Table 3.66.4.1.2.1-1: Values for code for status of List. The system portion of the token shall not be populated.
SHALL | designationType | `token` | This IHE extension on parameters defined as SearchParameter/List-DesignationType, of type token, specifies the designation type of the List. The value of the designation type element indicates the clinical purpose of the SubmissionSet or Folder. Note that servers that do not support this extended search parameter will ignore it, and thus return more results than expected.
SHALL | sourceId | `token` | This IHE extension on parameters defined as SearchParameter/List-SourceId, of type token, specifies the source (author) value supplied in the List Resource.

#### Resource Conformance: supported Binary

Core FHIR Resource
Binary
Reference Policy
Interaction summary

- Supports `read`.