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-20 |
<Requirements xmlns="http://hl7.org/fhir">
<id value="RespondtoRequestVHLDocuments"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Requirements RespondtoRequestVHLDocuments</b></p><a name="RespondtoRequestVHLDocuments"> </a><a name="hcRespondtoRequestVHLDocuments"> </a><p>These requirements apply to the actor <a href="ActorDefinition-VHLSharer.html">VHL Sharer</a></p><table class="grid"><tr><td><b><a name="authenticate-receiver"> </a></b>Authenticate the Receiver</td><td>MAY</td><td><div><p>Where one of the Sign Manifest Request Options is supported, authenticate the requesting <a href="ActorDefinition-VHLReceiver.html">VHL Receiver</a> against the trust network before releasing any manifest content, and reject the request where the Receiver cannot be authenticated</p>
</div></td></tr><tr><td><b><a name="authorize-request"> </a></b>Authorize the request</td><td>SHALL</td><td><div><p>Confirm that the presented VHL is valid, unexpired and not revoked, that any required passcode is satisfied, and that the VHL authorizes the documents requested</p>
</div></td></tr><tr><td><b><a name="return-manifest"> </a></b>Return the manifest</td><td>SHALL</td><td><div><p>Return a FHIR searchset Bundle containing only those documents the VHL authorizes, applying any consent-based filtering in force</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, in accordance with the <a href="Requirements-AuditEventAccess.html">Audit Event – Accessed Health Data</a> requirement</p>
</div></td></tr></table></div>
</text>
<url
value="https://profiles.ihe.net/ITI/VHL/Requirements/RespondtoRequestVHLDocuments"/>
<version value="1.0.0-comment"/>
<name value="RespondtoRequestVHLDocuments"/>
<title value="Respond to Request VHL Documents"/>
<status value="active"/>
<date value="2026-11-20T09:11:02+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="The [VHL Sharer](ActorDefinition-VHLSharer.html) SHALL respond to a manifest request from a [VHL Receiver](ActorDefinition-VHLReceiver.html) that presents a previously issued Verifiable Health Link (VHL), returning only those documents the VHL authorizes.
Before any manifest content is released, the Sharer SHALL establish that the VHL presented is valid and authorizes what is being requested.
Authentication of the requesting Receiver is a separate and optional control, provided by the three Sign Manifest Request Options. Where the Sharer claims one of them it authenticates the Receiver against the trust network using PKI material published by the [Trust Anchor](ActorDefinition-TrustAnchor.html) before releasing any manifest content. Where it does not, release of the manifest follows from a valid VHL and, where the `P` flag is set, the correct passcode.
**Optional behaviors:**
* The VHL Sharer MAY record an audit event documenting the access, in accordance with the [Audit Event – Accessed Health Data](Requirements-AuditEventAccess.html) requirement.
* The VHL Sharer MAY apply rate limiting per Receiver or per folder ID, and log failed authentication and authorization attempts."/>
<jurisdiction>
<coding>
<system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
<code value="001"/>
</coding>
</jurisdiction>
<statement>
<key value="authenticate-receiver"/>
<label value="Authenticate the Receiver"/>
<conformance value="MAY"/>
<requirement
value="Where one of the Sign Manifest Request Options is supported, authenticate the requesting [VHL Receiver](ActorDefinition-VHLReceiver.html) against the trust network before releasing any manifest content, and reject the request where the Receiver cannot be authenticated"/>
</statement>
<statement>
<key value="authorize-request"/>
<label value="Authorize the request"/>
<conformance value="SHALL"/>
<requirement
value="Confirm that the presented VHL is valid, unexpired and not revoked, that any required passcode is satisfied, and that the VHL authorizes the documents requested"/>
</statement>
<statement>
<key value="return-manifest"/>
<label value="Return the manifest"/>
<conformance value="SHALL"/>
<requirement
value="Return a FHIR searchset Bundle containing only those documents the VHL authorizes, applying any consent-based filtering in force"/>
</statement>
<statement>
<key value="record-audit-event"/>
<label value="Record audit event"/>
<conformance value="MAY"/>
<requirement
value="Record an audit event documenting the access, in accordance with the [Audit Event – Accessed Health Data](Requirements-AuditEventAccess.html) requirement"/>
</statement>
</Requirements>