SMART Base
0.3.0 - ci-build

SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.3.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/litlfred/smart-base/ and changes regularly. See the Directory of published versions

Logical Model: Knowledge graph L1: Recommendation

Official URL: http://smart.who.int/base/StructureDefinition/KGRecommendation Version: 0.3.0
Active as of 2026-10-06 Computable Name: KGRecommendation

The atomic normative statement. This is the node nothing in the WHO estate currently makes addressable. statement is a VERBATIM quote, never a paraphrase — a paraphrased recommendation is a new recommendation. strength is GRADE (strong conditional); certainty is GRADE (high moderate low very-low); conditionality records the 'in settings where…' qualifier that decides whether a DAK can adopt it unchanged. Class IRI: http://smart.who.int/kg/recommendation.

Usages:

  • This Logical Model is not used by any profiles in this Specification

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. KGRecommendation 0..* Base Knowledge graph L1: Recommendation
... identifier 0..1 string Identifier
... statement 0..1 markdown Statement
... strength 0..1 code Strength
Binding: Knowledge graph: GRADE recommendation strength (required)
... conditionality 0..1 string Conditionality
... status 0..1 string Status

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
KGRecommendation.strength Base required Knowledge graph: GRADE recommendation strength 📦0.3.0 This IG
KGRecommendation.certainty Base required Knowledge graph: GRADE certainty of evidence 📦0.3.0 This IG

API Information

Knowledge graph L1: Recommendation API

The atomic normative statement. This is the node nothing in the WHO estate currently makes addressable. statement is a VERBATIM quote, never a paraphrase — a paraphrased recommendation is a new recommendation. strength is GRADE (strong | conditional); certainty is GRADE (high | moderate | low | very-low); conditionality records the 'in settings where…' qualifier that decides whether a DAK can adopt it unchanged. Class IRI: http://smart.who.int/kg/recommendation.

Version: 1.0.0

Endpoints

GET /StructureDefinition-KGRecommendation.schema.json

JSON Schema definition for the Logical Model StructureDefinition-KGRecommendation

This endpoint serves the JSON Schema definition for the Logical Model StructureDefinition-KGRecommendation.

Schema Definition

StructureDefinition-KGRecommendation

Description: The atomic normative statement. This is the node nothing in the WHO estate currently makes addressable. statement is a VERBATIM quote, never a paraphrase — a paraphrased recommendation is a new recommendation. strength is GRADE (strong | conditional); certainty is GRADE (high | moderate | low | very-low); conditionality records the 'in settings where…' qualifier that decides whether a DAK can adopt it unchanged. Class IRI: http://smart.who.int/kg/recommendation.

Type: object

Full Schema (JSON)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "http://smart.who.int/base/StructureDefinition-KGRecommendation.schema.json",
  "title": "Knowledge graph L1: Recommendation",
  "description": "The atomic normative statement. This is the node nothing in the WHO estate currently makes addressable. statement is a VERBATIM quote, never a paraphrase \u2014 a paraphrased recommendation is a new recommendation. strength is GRADE (strong | conditional); certainty is GRADE (high | moderate | low | very-low); conditionality records the 'in settings where\u2026' qualifier that decides whether a DAK can adopt it unchanged. Class IRI: http://smart.who.int/kg/recommendation.",
  "type": "object",
  "properties": {
    "resourceType": {
      "type": "string",
      "const": "KGRecommendation",
      "description": "Resource type identifier for KGRecommendation logical model"
    },
    "@context": {
      "description": "JSON-LD context for this logical model with ValueSet vocabularies",
      "anyOf": [
        {
          "type": "string",
          "format": "uri",
          "description": "URI reference to external JSON-LD context"
        },
        {
          "type": "object",
          "description": "Inline JSON-LD context",
          "properties": {
            "@version": {
              "type": "number",
              "const": 1.1
            },
            "fhir": {
              "type": "string",
              "const": "http://hl7.org/fhir/"
            }
          },
          "additionalProperties": {
            "type": "string",
            "format": "uri"
          }
        },
        {
          "type": "array",
          "description": "Array of JSON-LD context objects/URIs",
          "items": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "object"
              }
            ]
          }
        }
      ]
    },
    "@type": {
      "type": "string",
      "description": "JSON-LD type identifier for KGRecommendation logical model",
      "examples": [
        "LogicalModel-KGRecommendation"
      ]
    },
    "identifier": {
      "type": "string",
      "description": "The recommendation's label or number as printed."
    },
    "statement": {
      "type": "string",
      "description": "The recommendation text, VERBATIM. A paraphrased recommendation is a new recommendation."
    },
    "strength": {
      "oneOf": [
        {
          "type": "string",
          "description": "Code from ValueSet KGGradeStrengthVS (plain string)"
        },
        {
          "type": "object",
          "description": "Code from ValueSet KGGradeStrengthVS (JSON-LD structure)",
          "properties": {
            "@type": {
              "type": "string",
              "const": "http://smart.who.int/base/ValueSet-KGGradeStrengthVS.jsonld",
              "description": "JSON-LD type reference to ValueSet KGGradeStrengthVS"
            },
            "@id": {
              "type": "string",
              "format": "uri",
              "description": "Full IRI of the code from ValueSet KGGradeStrengthVS"
            }
          },
          "required": [
            "@type",
            "@id"
          ],
          "additionalProperties": false
        }
      ],
      "description": "GRADE strength, as stated in the source."
    },
    "certainty": {
      "oneOf": [
        {
          "type": "string",
          "description": "Code from ValueSet KGGradeCertaintyVS (plain string)"
        },
        {
          "type": "object",
          "description": "Code from ValueSet KGGradeCertaintyVS (JSON-LD structure)",
          "properties": {
            "@type": {
              "type": "string",
              "const": "http://smart.who.int/base/ValueSet-KGGradeCertaintyVS.jsonld",
              "description": "JSON-LD type reference to ValueSet KGGradeCertaintyVS"
            },
            "@id": {
              "type": "string",
              "format": "uri",
              "description": "Full IRI of the code from ValueSet KGGradeCertaintyVS"
            }
          },
          "required": [
            "@type",
            "@id"
          ],
          "additionalProperties": false
        }
      ],
      "description": "GRADE certainty of evidence, as stated in the source."
    },
    "conditionality": {
      "type": "string",
      "description": "The 'in settings where\u2026' qualifier, verbatim, that decides whether a DAK can adopt the recommendation unchanged."
    },
    "status": {
      "type": "string",
      "description": "The recommendation's standing in its publication (for example current or superseded), as stated."
    }
  },
  "required": [
    "resourceType"
  ],
  "resourceDefinition": "http://smart.who.int/base/StructureDefinition/KGRecommendation",
  "fhir:parent": "http://hl7.org/fhir/StructureDefinition/Base",
  "jsonld:valuesets": [
    "KGGradeStrengthVS",
    "KGGradeCertaintyVS"
  ],
  "jsonld:contextTemplate": {
    "@version": 1.1,
    "fhir": "http://hl7.org/fhir/",
    "KGGradeStrengthVS": "http://smart.who.int/base/ValueSet-KGGradeStrengthVS.jsonld",
    "KGGradeCertaintyVS": "http://smart.who.int/base/ValueSet-KGGradeCertaintyVS.jsonld"
  }
}

This documentation is automatically generated from the OpenAPI specification.

This structure is derived from Base

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. KGRecommendation 0..* Base Knowledge graph L1: Recommendation
... identifier 0..1 string Identifier
... statement 0..1 markdown Statement
... strength 0..1 code Strength
Binding: Knowledge graph: GRADE recommendation strength (required)
... conditionality 0..1 string Conditionality
... status 0..1 string Status

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
KGRecommendation.strength Base required Knowledge graph: GRADE recommendation strength 📦0.3.0 This IG
KGRecommendation.certainty Base required Knowledge graph: GRADE certainty of evidence 📦0.3.0 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. KGRecommendation 0..* Base Knowledge graph L1: Recommendation
... identifier 0..1 string Identifier
... statement 0..1 markdown Statement
... strength 0..1 code Strength
Binding: Knowledge graph: GRADE recommendation strength (required)
... conditionality 0..1 string Conditionality
... status 0..1 string Status

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
KGRecommendation.strength Base required Knowledge graph: GRADE recommendation strength 📦0.3.0 This IG
KGRecommendation.certainty Base required Knowledge graph: GRADE certainty of evidence 📦0.3.0 This IG

This structure is derived from Base

Summary

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. KGRecommendation 0..* Base Knowledge graph L1: Recommendation
... identifier 0..1 string Identifier
... statement 0..1 markdown Statement
... strength 0..1 code Strength
Binding: Knowledge graph: GRADE recommendation strength (required)
... conditionality 0..1 string Conditionality
... status 0..1 string Status

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
KGRecommendation.strength Base required Knowledge graph: GRADE recommendation strength 📦0.3.0 This IG
KGRecommendation.certainty Base required Knowledge graph: GRADE certainty of evidence 📦0.3.0 This IG

Differential View

This structure is derived from Base

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. KGRecommendation 0..* Base Knowledge graph L1: Recommendation
... identifier 0..1 string Identifier
... statement 0..1 markdown Statement
... strength 0..1 code Strength
Binding: Knowledge graph: GRADE recommendation strength (required)
... conditionality 0..1 string Conditionality
... status 0..1 string Status

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
KGRecommendation.strength Base required Knowledge graph: GRADE recommendation strength 📦0.3.0 This IG
KGRecommendation.certainty Base required Knowledge graph: GRADE certainty of evidence 📦0.3.0 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. KGRecommendation 0..* Base Knowledge graph L1: Recommendation
... identifier 0..1 string Identifier
... statement 0..1 markdown Statement
... strength 0..1 code Strength
Binding: Knowledge graph: GRADE recommendation strength (required)
... conditionality 0..1 string Conditionality
... status 0..1 string Status

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
KGRecommendation.strength Base required Knowledge graph: GRADE recommendation strength 📦0.3.0 This IG
KGRecommendation.certainty Base required Knowledge graph: GRADE certainty of evidence 📦0.3.0 This IG

This structure is derived from Base

Summary

 

Other representations of profile: CSV, Excel