SMART Health Cards: Terminology
0.1.0 - ci-build

SMART Health Cards: Terminology - Local Development build (v0.1.0). See the Directory of published versions


Official URL: Version: 0.1.0
Draft as of 2023-02-03 Computable Name: SMARTHealthCardsTerminology

This website is a community-maintained terminology resource for implementers of SMART Health Cards.

It provides both human-readable terminology resources, as well as computable versions in the form of JSON representations of FHIR Resources.


Typically, SMART Health Cards for vaccines use either CVX or SNOMED CT to identify the administered vaccine. ICD-11 may also be used. For more details please see the SMART Health Cards Vaccination Profile for more information.

The following ValueSets are provided to assist implementers wishing to identify vaccines for specific diseases:

  • COVID-19
  • Monkeypox
    • CVX
    • ICD-11 (forthcoming)
    • SNOMED CT (forthcoming)

SMART Health Cards use LOINC to identify laboratory tests related to infectious diseases (including COVID-19).

Lab test results are identified using SNOMED CT whenever possible, with LOINC Answer codes as a fallback.

The following ValueSets are provided to assist implementers of SMART Health Cards representing infectious disease-related laboratory tests and test results:

SMART Health Card Types

The health card type code system contains the codes used to identify the credential type. See the SMART Health Cards specification for more information.

Identity Assurance Level

These codes may be used by Issuers of SMART Health Cards to record if/how a patient’s identity was verified at the point of care. For example, if a patient showed their driver’s license to verify their name and date of birth when getting a vaccination, this would correspond to IAL1.4.


ValueSets from medical terminology (e.g., CVX, LOINC, etc.) are versioned using a YYYY.n format where YYYY is the year a given version was created and n is an incremented integer.

Other terminology resources are versioned with semantic versioning.

(Semantic versioning is not used for the medical terminology ValueSets because that there is no notion of “incompatible” changes, meaning that the first semantic versioning digit representing the “major” version would never be incremented. This would eventually lead to version numbers like 1.1234.0.)

Contact Information

For technical questions, please post on the smart/health-cards Zulip stream at (free account required).

This website is maintained for the SMART Health Card implementer community by VCI.


The source code for this website and the FHIR resources contained within are available on GitHub, and community contributions are welcome. Please see for details.