WHO SMART Trust
1.1.6 - CI Build
WHO SMART Trust, published by WHO. This guide is not an authorized publication; it is the continuous build for version 1.1.6 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-trust/tree/VHLPayload and changes regularly. See the Directory of published versions
| Official URL: https://profiles.ihe.net/ITI/VHL/StructureDefinition/VerifiableHealthLinkPayload | Version: 1.1.6 | |||
| Draft as of 2025-02-21 | Computable Name: VerifiableHealthLinkPayload | |||
Verifiable Health Link Payload (DRAFT)
This logical model constrains the Health Link Payload for a Verifiable Health Link
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
0..* | HealthLinkPayload | Elements defined in Ancestors:url, key, exp, flag, label, v, type Verifiable Health Link Payload (DRAFT) Instances of this logical model can be the target of a Reference | |
![]() ![]() |
1..1 | string | url | |
![]() ![]() |
1..1 | string | Decryption key for processing files returned in the manifest. 43 characters, consisting of 32 random bytes base64urlencoded. | |
![]() ![]() |
0..1 | string | Optional. Number representing expiration time in Epoch seconds, as a hint to help the Health Link Receiving Application determine if this QR is stale. (Note: epoch times should be parsed into 64-bit numeric types.) | |
![]() ![]() |
0..1 | string | Optional. String created by concatenating single-character flags in alphabetical order: 'L' indicates the Health Link is intended for long-term use and manifest content can evolve over time; 'P' indicates the Health Link requires a Passcode to resolves; and 'U' indicates the Health Link's url resolves to a single encrypted file accessible via GET, bypassing the manifest and SHALL NOT be used in combination with P. </ul> | |
![]() ![]() |
0..1 | string | Optional. String no longer than 80 characters that provides a short description of the data behind the Health Link. | |
![]() ![]() |
0..1 | string | Optional. Integer representing the Health Links protocol version this Health Link conforms to. MAY be omitted when the default value (1) applies. | |
![]() ![]() |
C | 1..1 | code | Classifying type code to distinguish different types of health links. If not present then the Health Link is a SMART Health Link. Binding: HL.TYPE ValueSet (preferred) is-a-verifiable-health-link: The Health Link type is is a verifiable health link |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| VerifiableHealthLinkPayload.type | preferred | HL_TYPE (a valid code from HL Type CodeSystem)http://smart.who.int/trust/ValueSet/HL.TYPEfrom this IG |
| Id | Grade | Path(s) | Details | Requirements |
| is-a-verifiable-health-link | error | VerifiableHealthLinkPayload.type | The Health Link type is is a verifiable health link : type = 'vhl' |
This structure is derived from HealthLinkPayload
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
0..* | HealthLinkPayload | Elements defined in Ancestors:url, key, exp, flag, label, v, type Verifiable Health Link Payload (DRAFT) Instances of this logical model can be the target of a Reference | |
![]() ![]() |
C | 1..1 | code | Classifying type code to distinguish different types of health links. If not present then the Health Link is a SMART Health Link. Binding: HL.TYPE ValueSet (preferred) is-a-verifiable-health-link: The Health Link type is is a verifiable health link |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| VerifiableHealthLinkPayload.type | preferred | HL_TYPE (a valid code from HL Type CodeSystem)http://smart.who.int/trust/ValueSet/HL.TYPEfrom this IG |
| Id | Grade | Path(s) | Details | Requirements |
| is-a-verifiable-health-link | error | VerifiableHealthLinkPayload.type | The Health Link type is is a verifiable health link : type = 'vhl' |
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
0..* | HealthLinkPayload | Elements defined in Ancestors:url, key, exp, flag, label, v, type Verifiable Health Link Payload (DRAFT) Instances of this logical model can be the target of a Reference | |
![]() ![]() |
1..1 | string | url | |
![]() ![]() |
1..1 | string | Decryption key for processing files returned in the manifest. 43 characters, consisting of 32 random bytes base64urlencoded. | |
![]() ![]() |
0..1 | string | Optional. Number representing expiration time in Epoch seconds, as a hint to help the Health Link Receiving Application determine if this QR is stale. (Note: epoch times should be parsed into 64-bit numeric types.) | |
![]() ![]() |
0..1 | string | Optional. String created by concatenating single-character flags in alphabetical order: 'L' indicates the Health Link is intended for long-term use and manifest content can evolve over time; 'P' indicates the Health Link requires a Passcode to resolves; and 'U' indicates the Health Link's url resolves to a single encrypted file accessible via GET, bypassing the manifest and SHALL NOT be used in combination with P. </ul> | |
![]() ![]() |
0..1 | string | Optional. String no longer than 80 characters that provides a short description of the data behind the Health Link. | |
![]() ![]() |
0..1 | string | Optional. Integer representing the Health Links protocol version this Health Link conforms to. MAY be omitted when the default value (1) applies. | |
![]() ![]() |
C | 1..1 | code | Classifying type code to distinguish different types of health links. If not present then the Health Link is a SMART Health Link. Binding: HL.TYPE ValueSet (preferred) is-a-verifiable-health-link: The Health Link type is is a verifiable health link |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| VerifiableHealthLinkPayload.type | preferred | HL_TYPE (a valid code from HL Type CodeSystem)http://smart.who.int/trust/ValueSet/HL.TYPEfrom this IG |
| Id | Grade | Path(s) | Details | Requirements |
| is-a-verifiable-health-link | error | VerifiableHealthLinkPayload.type | The Health Link type is is a verifiable health link : type = 'vhl' |
This structure is derived from HealthLinkPayload
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
0..* | HealthLinkPayload | Elements defined in Ancestors:url, key, exp, flag, label, v, type Verifiable Health Link Payload (DRAFT) Instances of this logical model can be the target of a Reference | |
![]() ![]() |
1..1 | string | url | |
![]() ![]() |
1..1 | string | Decryption key for processing files returned in the manifest. 43 characters, consisting of 32 random bytes base64urlencoded. | |
![]() ![]() |
0..1 | string | Optional. Number representing expiration time in Epoch seconds, as a hint to help the Health Link Receiving Application determine if this QR is stale. (Note: epoch times should be parsed into 64-bit numeric types.) | |
![]() ![]() |
0..1 | string | Optional. String created by concatenating single-character flags in alphabetical order: 'L' indicates the Health Link is intended for long-term use and manifest content can evolve over time; 'P' indicates the Health Link requires a Passcode to resolves; and 'U' indicates the Health Link's url resolves to a single encrypted file accessible via GET, bypassing the manifest and SHALL NOT be used in combination with P. </ul> | |
![]() ![]() |
0..1 | string | Optional. String no longer than 80 characters that provides a short description of the data behind the Health Link. | |
![]() ![]() |
0..1 | string | Optional. Integer representing the Health Links protocol version this Health Link conforms to. MAY be omitted when the default value (1) applies. | |
![]() ![]() |
C | 1..1 | code | Classifying type code to distinguish different types of health links. If not present then the Health Link is a SMART Health Link. Binding: HL.TYPE ValueSet (preferred) is-a-verifiable-health-link: The Health Link type is is a verifiable health link |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| VerifiableHealthLinkPayload.type | preferred | HL_TYPE (a valid code from HL Type CodeSystem)http://smart.who.int/trust/ValueSet/HL.TYPEfrom this IG |
| Id | Grade | Path(s) | Details | Requirements |
| is-a-verifiable-health-link | error | VerifiableHealthLinkPayload.type | The Health Link type is is a verifiable health link : type = 'vhl' |
Differential View
This structure is derived from HealthLinkPayload
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
0..* | HealthLinkPayload | Elements defined in Ancestors:url, key, exp, flag, label, v, type Verifiable Health Link Payload (DRAFT) Instances of this logical model can be the target of a Reference | |
![]() ![]() |
C | 1..1 | code | Classifying type code to distinguish different types of health links. If not present then the Health Link is a SMART Health Link. Binding: HL.TYPE ValueSet (preferred) is-a-verifiable-health-link: The Health Link type is is a verifiable health link |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| VerifiableHealthLinkPayload.type | preferred | HL_TYPE (a valid code from HL Type CodeSystem)http://smart.who.int/trust/ValueSet/HL.TYPEfrom this IG |
| Id | Grade | Path(s) | Details | Requirements |
| is-a-verifiable-health-link | error | VerifiableHealthLinkPayload.type | The Health Link type is is a verifiable health link : type = 'vhl' |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() |
0..* | HealthLinkPayload | Elements defined in Ancestors:url, key, exp, flag, label, v, type Verifiable Health Link Payload (DRAFT) Instances of this logical model can be the target of a Reference | |
![]() ![]() |
1..1 | string | url | |
![]() ![]() |
1..1 | string | Decryption key for processing files returned in the manifest. 43 characters, consisting of 32 random bytes base64urlencoded. | |
![]() ![]() |
0..1 | string | Optional. Number representing expiration time in Epoch seconds, as a hint to help the Health Link Receiving Application determine if this QR is stale. (Note: epoch times should be parsed into 64-bit numeric types.) | |
![]() ![]() |
0..1 | string | Optional. String created by concatenating single-character flags in alphabetical order: 'L' indicates the Health Link is intended for long-term use and manifest content can evolve over time; 'P' indicates the Health Link requires a Passcode to resolves; and 'U' indicates the Health Link's url resolves to a single encrypted file accessible via GET, bypassing the manifest and SHALL NOT be used in combination with P. </ul> | |
![]() ![]() |
0..1 | string | Optional. String no longer than 80 characters that provides a short description of the data behind the Health Link. | |
![]() ![]() |
0..1 | string | Optional. Integer representing the Health Links protocol version this Health Link conforms to. MAY be omitted when the default value (1) applies. | |
![]() ![]() |
C | 1..1 | code | Classifying type code to distinguish different types of health links. If not present then the Health Link is a SMART Health Link. Binding: HL.TYPE ValueSet (preferred) is-a-verifiable-health-link: The Health Link type is is a verifiable health link |
Documentation for this format | ||||
| Path | Conformance | ValueSet | URI |
| VerifiableHealthLinkPayload.type | preferred | HL_TYPE (a valid code from HL Type CodeSystem)http://smart.who.int/trust/ValueSet/HL.TYPEfrom this IG |
| Id | Grade | Path(s) | Details | Requirements |
| is-a-verifiable-health-link | error | VerifiableHealthLinkPayload.type | The Health Link type is is a verifiable health link : type = 'vhl' |
This structure is derived from HealthLinkPayload