WHO SMART Trust
1.5.0 - release

WHO SMART Trust, published by WHO. This guide is not an authorized publication; it is the continuous build for version 1.5.0 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/v1.5.0-release-candidate and changes regularly. See the Directory of published versions

## ValueSet: WHO GDHCN Key Usage ValueSet (Experimental)

Official URL: http://smart.who.int/trust/ValueSet/KeyUsage | Version: 1.5.0
Active as of 2026-04-27 | Computable Name: KeyUsage

ValueSet of codes for key usage codes for Production environment

References

This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

### Logical Definition (CLD)

- Include these codes as defined in `http://smart.who.int/trust/CodeSystem/KeyUsage` version 📦1.5.0

  Code | Display | Definition
  SCA | Signing Certificate Authority | A certificate which acts a trust anchor in the verification of the certificate chain for the DSCs issued by a Trust Network participant
  DSC | Document Signing Certificate | A certificate which may be used to verify a digital signature within a Verfifiable Digital Health Certificate
  UP | Upload | Used to verify digital signature of cryptographically signed content uploaded to services within the Global Digital Health Certification Network, in particular the Trust Network Gateway
  TLS | TLS | Used for establishing (m)TLS connections with systems, in particular between the Trust Network Gateway and backend systems of a Trust Network Participant

### Expansion

Expansion performed internally based on codesystem WHO GDHCN Key Usage CodeSystem v1.5.0 (CodeSystem)

This value set contains 4 concepts

System | Code | Display (en) | Definition | JSON | XML
`http://smart.who.int/trust/CodeSystem/KeyUsage` | SCA | Signing Certificate Authority | A certificate which acts a trust anchor in the verification of the certificate chain for the DSCs issued by a Trust Network participant |  |
`http://smart.who.int/trust/CodeSystem/KeyUsage` | DSC | Document Signing Certificate | A certificate which may be used to verify a digital signature within a Verfifiable Digital Health Certificate |  |
`http://smart.who.int/trust/CodeSystem/KeyUsage` | UP | Upload | Used to verify digital signature of cryptographically signed content uploaded to services within the Global Digital Health Certification Network, in particular the Trust Network Gateway |  |
`http://smart.who.int/trust/CodeSystem/KeyUsage` | TLS | TLS | Used for establishing (m)TLS connections with systems, in particular between the Trust Network Gateway and backend systems of a Trust Network Participant |  |

Explanation of the columns that may appear on this page:

Level | A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies
System | The source of the definition of the code (when the value set draws in codes defined elsewhere)
Code | The code (used as the code in the resource instance)
Display | The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application
Definition | An explanation of the meaning of the concept
Comments | Additional notes about how to use the code

## API Information

##### WHO GDHCN Key Usage ValueSet Schema API

JSON Schema for WHO GDHCN Key Usage ValueSet ValueSet codes. Generated from FHIR expansions using IRI format.

Version: 1.0.0

## Endpoints

### GET /ValueSet-KeyUsage.schema.json

#### JSON Schema definition for the enumeration ValueSet-KeyUsage

This endpoint serves the JSON Schema definition for the enumeration ValueSet-KeyUsage.

## Schema Definition

### ValueSet-KeyUsage

Description: JSON Schema for WHO GDHCN Key Usage ValueSet ValueSet codes. Generated from FHIR expansions using IRI format.

Type: string

Full Schema (JSON)

    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "$id": "http://smart.who.int/trust/ValueSet-KeyUsage.schema.json",
      "title": "WHO GDHCN  Key Usage ValueSet Schema",
      "description": "JSON Schema for WHO GDHCN  Key Usage ValueSet ValueSet codes. Generated from FHIR expansions using IRI format.",
      "type": "string",
      "enum": [
        "http://smart.who.int/trust/CodeSystem/KeyUsage#SCA",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#DSC",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#DECA",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#DESC",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#TLS",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#UP",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#SCA",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#DSC",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#UP",
        "http://smart.who.int/trust/CodeSystem/KeyUsage#TLS"
      ],
      "narrative": "This schema validates IRI-formatted codes for the WHO GDHCN  Key Usage ValueSet ValueSet. Each enum value includes the system URI in the format {systemuri}#{code} to match JSON-LD enumeration IRIs. Display values are available at http://smart.who.int/trust/ValueSet-KeyUsage.displays.json. For a complete listing of all ValueSets, see artifacts.html#terminology-value-sets.",
      "fhir:displays": "http://smart.who.int/trust/ValueSet-KeyUsage.displays.json",
      "fhir:valueSet": "http://smart.who.int/trust/ValueSet/KeyUsage",
      "fhir:version": "1.5.0",
      "fhir:expansionTimestamp": "2026-04-27T07:15:52.160997"
    }

This documentation is automatically generated from the OpenAPI specification.