{
  "openapi": "3.0.3",
  "info": {
    "title": "Knowledge graph L1: Recommendation API",
    "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.",
    "version": "1.0.0"
  },
  "paths": {
    "/StructureDefinition-KGRecommendation.schema.json": {
      "get": {
        "summary": "JSON Schema definition for the Logical Model StructureDefinition-KGRecommendation",
        "description": "This endpoint serves the JSON Schema definition for the Logical Model StructureDefinition-KGRecommendation.",
        "responses": {
          "200": {
            "description": "The JSON Schema for StructureDefinition-KGRecommendation",
            "content": {
              "application/schema+json": {
                "schema": {
                  "$ref": "./StructureDefinition-KGRecommendation.schema.json"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "StructureDefinition-KGRecommendation": {
        "$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 — 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",
        "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…' 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"
        }
      }
    }
  }
}