Verifiable Health Links
1.0.0-comment - ballot
Verifiable Health Links, published by IHE IT Infrastructure Technical Committee. This guide is not an authorized publication; it is the continuous build for version 1.0.0-comment built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/ITI.VHL/ and changes regularly. See the Directory of published versions
| Active as of 2026-11-13 |
<Requirements xmlns="http://hl7.org/fhir">
<id value="RequestVHLDocument"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Requirements RequestVHLDocument</b></p><a name="RequestVHLDocument"> </a><a name="hcRequestVHLDocument"> </a><p>These requirements apply to the actor <a href="ActorDefinition-VHLReceiver.html">VHL Receiver</a></p><table class="grid"><tr><td><b><a name="retrieve-health-document"> </a></b>Retrieve an individual document</td><td>SHALL</td><td><div><p>Retrieve an individual health document referenced by a previously obtained manifest, using <a href="https://profiles.ihe.net/ITI/MHD/ITI-68.html">MHD ITI-68 Retrieve Document</a></p>
</div></td></tr><tr><td><b><a name="decrypt-document"> </a></b>Decrypt the document</td><td>SHALL</td><td><div><p>Decrypt the retrieved binary using the symmetric key carried in the <code>key</code> field of the VHL payload</p>
</div></td></tr><tr><td><b><a name="verify-digital-signature"> </a></b>Verify digital signature</td><td>MAY</td><td><div><p>Verify the digital signature of the returned health document to confirm its authenticity, integrity, and provenance, as defined in the <a href="Requirements-VerifyDocumentSignature.html">Verify Document Signature</a> requirement</p>
</div></td></tr><tr><td><b><a name="record-audit-event"> </a></b>Record audit event</td><td>MAY</td><td><div><p>Record an audit event documenting the access request by the Receiver, in accordance with the <a href="Requirements-AuditEventReceived.html">Audit Event – Received Health Data</a> requirement</p>
</div></td></tr></table></div>
</text>
<url
value="https://profiles.ihe.net/ITI/VHL/Requirements/RequestVHLDocument"/>
<version value="1.0.0-comment"/>
<name value="RequestVHLDocument"/>
<title value="Request VHL Document"/>
<status value="active"/>
<date value="2026-11-13T03:15:18+00:00"/>
<publisher value="IHE IT Infrastructure Technical Committee"/>
<contact>
<telecom>
<system value="url"/>
<value value="https://www.ihe.net/ihe_domains/it_infrastructure/"/>
</telecom>
</contact>
<contact>
<telecom>
<system value="email"/>
<value value="iti@ihe.net"/>
</telecom>
</contact>
<contact>
<name value="IHE IT Infrastructure Technical Committee"/>
<telecom>
<system value="email"/>
<value value="iti@ihe.net"/>
</telecom>
</contact>
<description
value="Having obtained a manifest through [Retrieve Manifest [ITI-YY5]](ITI-YY5.html), the [VHL Receiver](ActorDefinition-VHLReceiver.html) SHALL retrieve each health document it needs from the location that manifest gives for it, using [MHD ITI-68 Retrieve Document](https://profiles.ihe.net/ITI/MHD/ITI-68.html).
Document binaries are encrypted. The Receiver decrypts each one using the symmetric key carried in the `key` field of the VHL payload.
**Optional behaviors:**
* The VHL Receiver MAY verify the digital signature of the returned health document to confirm its authenticity, integrity, and provenance, as defined in the [Verify Document Signature](Requirements-VerifyDocumentSignature.html) requirement.
* The VHL Sharer MAY record an audit event documenting the access request by the Receiver, in accordance with the [Audit Event – Received Health Data](Requirements-AuditEventReceived.html) requirement."/>
<jurisdiction>
<coding>
<system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
<code value="001"/>
</coding>
</jurisdiction>
<statement>
<key value="retrieve-health-document"/>
<label value="Retrieve an individual document"/>
<conformance value="SHALL"/>
<requirement
value="Retrieve an individual health document referenced by a previously obtained manifest, using [MHD ITI-68 Retrieve Document](https://profiles.ihe.net/ITI/MHD/ITI-68.html)"/>
</statement>
<statement>
<key value="decrypt-document"/>
<label value="Decrypt the document"/>
<conformance value="SHALL"/>
<requirement
value="Decrypt the retrieved binary using the symmetric key carried in the `key` field of the VHL payload"/>
</statement>
<statement>
<key value="verify-digital-signature"/>
<label value="Verify digital signature"/>
<conformance value="MAY"/>
<requirement
value="Verify the digital signature of the returned health document to confirm its authenticity, integrity, and provenance, as defined in the [Verify Document Signature](Requirements-VerifyDocumentSignature.html) requirement"/>
</statement>
<statement>
<key value="record-audit-event"/>
<label value="Record audit event"/>
<conformance value="MAY"/>
<requirement
value="Record an audit event documenting the access request by the Receiver, in accordance with the [Audit Event – Received Health Data](Requirements-AuditEventReceived.html) requirement"/>
</statement>
</Requirements>