Verifiable Health Links
1.0.0-comment - ballot International flag

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

: Request VHL Document - JSON Representation

Active as of 2026-11-13

Raw json | Download

{
  "resourceType" : "Requirements",
  "id" : "RequestVHLDocument",
  "text" : {
    "status" : "generated",
    "div" : "<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>\n</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>\n</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>\n</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>\n</div></td></tr></table></div>"
  },
  "url" : "https://profiles.ihe.net/ITI/VHL/Requirements/RequestVHLDocument",
  "version" : "1.0.0-comment",
  "name" : "RequestVHLDocument",
  "title" : "Request VHL Document",
  "status" : "active",
  "date" : "2026-11-13T03:15:18+00:00",
  "publisher" : "IHE IT Infrastructure Technical Committee",
  "contact" : [
    {
      "telecom" : [
        {
          "system" : "url",
          "value" : "https://www.ihe.net/ihe_domains/it_infrastructure/"
        }
      ]
    },
    {
      "telecom" : [
        {
          "system" : "email",
          "value" : "iti@ihe.net"
        }
      ]
    },
    {
      "name" : "IHE IT Infrastructure Technical Committee",
      "telecom" : [
        {
          "system" : "email",
          "value" : "iti@ihe.net"
        }
      ]
    }
  ],
  "description" : "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).\n\nDocument binaries are encrypted. The Receiver decrypts each one using the symmetric key carried in the `key` field of the VHL payload.\n\n**Optional behaviors:**\n* 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.\n* 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" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code" : "001"
        }
      ]
    }
  ],
  "statement" : [
    {
      "key" : "retrieve-health-document",
      "label" : "Retrieve an individual document",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "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)"
    },
    {
      "key" : "decrypt-document",
      "label" : "Decrypt the document",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Decrypt the retrieved binary using the symmetric key carried in the `key` field of the VHL payload"
    },
    {
      "key" : "verify-digital-signature",
      "label" : "Verify digital signature",
      "conformance" : [
        "MAY"
      ],
      "requirement" : "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"
    },
    {
      "key" : "record-audit-event",
      "label" : "Record audit event",
      "conformance" : [
        "MAY"
      ],
      "requirement" : "Record an audit event documenting the access request by the Receiver, in accordance with the [Audit Event – Received Health Data](Requirements-AuditEventReceived.html) requirement"
    }
  ]
}