Release 4 FHIR CI-Build

This page is part of the Continuous Integration Build of FHIR Specification (v4.0.1: R4 - Mixed Normative and STU ) in it's permanent home (it will always (will be available incorrect/inconsistent at this URL). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see times).
See the Directory of published versions . Page versions: R5 R4B R4 R3 R2

Valueset-use-context.json

Example ValueSet/use-context (JSON)

Maturity Level : N/A
Responsible Owner: Vocabulary Terminology Infrastructure Work Group Standards Status : Informative

Raw JSON ( canonical form + also see JSON Format Specification )

Definition for Value SetConformanceUseContext SetContext of Use ValueSet

{
  "resourceType" : "ValueSet",
  "id" : "use-context",
  "meta" : {
    "lastUpdated" : "2019-11-01T09:29:23.356+11:00",
    "profile" : ["http://hl7.org/fhir/StructureDefinition/shareablevalueset"]

    "lastUpdated" : "2025-11-12T19:40:08.403+00:00"

  },
  "text" : {
    "status" : "generated",
    "div" : "<div>!-- Snipped for Brevity --></div>"

    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ValueSet use-context</b></p><a name=\"use-context\"> </a><a name=\"hcuse-context\"> </a><p>This value set includes codes based on the following rules:</p><ul><li>Import all the codes that are contained in <a href=\"http://terminology.hl7.org/6.5.0/ValueSet-v2-0265.html\">hl7VS-specialtyType</a></li><li>Include codes from<a href=\"http://www.snomed.org/\"><code>http://snomed.info/sct</code></a><span title=\"Version is not explicity stated. No matching Code System found\"> version Not Stated (use latest from terminology server)</span> where concept  is-a 394733009 (Medical specialties)</li><li>Include all codes defined in <a href=\"http://terminology.hl7.org/6.5.0/CodeSystem-ISO3166Part1.html\"><code>urn:iso:std:iso:3166</code></a><span title=\"Version is not explicity stated. No matching Code System found\"> version Not Stated (use latest from terminology server)</span></li><li>Include codes from<code>http://unstats.un.org/unsd/methods/m49/m49.htm</code><span title=\"Version is not explicity stated. No matching Code System found\"> version Not Stated (use latest from terminology server)</span> where class  = region</li><li>Include codes from<a href=\"http://www.snomed.org/\"><code>http://snomed.info/sct</code></a><span title=\"Version is not explicity stated. No matching Code System found\"> version Not Stated (use latest from terminology server)</span> where concept  is-a 387961004 (Kingdom Animalia (organism))</li><li>Import all the codes that are contained in <a href=\"valueset-administrative-gender.html\">AdministrativeGender</a></li><li>Import all the codes that are contained in <a href=\"valueset-condition-code.html\">Condition/Problem/Diagnosis Codes</a></li><li>Include all codes defined in <a href=\"http://tx.fhir.org/r5\"><code>http://nucc.org/provider-taxonomy</code></a><span style=\"opacity: 0.5\" title=\"Version is not explicity stated. When building this specification, the most recent version 22.1 has been used\"> version ⏿22.1</span></li><li>Import all the codes that are contained in <a href=\"http://terminology.hl7.org/6.5.0/ValueSet-v3-ActEncounterCode.html\">ActEncounterCode</a></li><li>Import all the codes that are contained in <a href=\"http://terminology.hl7.org/6.5.0/ValueSet-v3-ActTaskCode.html\">ActTaskCode</a></li><li>Import all the codes that are contained in <a href=\"valueset-usage-context-agreement-scope.html\">Usage Context Agreement Scope</a></li></ul></div>"

  },
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "fhir"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "draft"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 1
  }],
  "url" : "http://hl7.org/fhir/ValueSet/use-context",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.3.28"
  }],
  "version" : "4.0.1",
  "name" : "Context of Use ValueSet",
  "title" : "ConformanceUseContext",

  "version" : "6.0.0-ballot3",
  "name" : "ContextOfUseValueSet",
  "title" : "Context of Use ValueSet",

  "status" : "draft",
  "experimental" : false,
  "date" : "2019-11-01T09:29:23+11:00",

  "experimental" : true,
  "date" : "2025-11-12T19:40:08+00:00",

  "publisher" : "FHIR Project team",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"
    }]
  }],
  "description" : "This value set defines a base set of codes that can be used to indicate that the content in a resource was developed with a focus and intent of supporting use within particular contexts.",
  "copyright" : "This resource includes content from SNOMED Clinical Terms® (SNOMED CT®) which is copyright of the International Health Terminology Standards Development Organisation (IHTSDO). Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact http://www.snomed.org/snomed-ct/get-snomed-ct or info@snomed.org. This value set includes content from NUCC Health Care Provider Taxonomy Code Set for providers which is copyright © 2016+ American Medical Association. For commercial use, including sales or licensing, a license must be obtained",

  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "copyright" : "This resource includes content from SNOMED Clinical Terms® (SNOMED CT®) which is copyright of the International Health Terminology Standards Development Organisation (IHTSDO). Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact http://www.snomed.org/snomed-ct/get-snomed-ct or info@snomed.org. This value set includes content from NUCC Health Care Provider Taxonomy Code Set for providers which is copyright © 2016+ American Medical Association. For commercial use, including sales or licensing, a license must be obtained",

  "compose" : {
    "include" : [{
      "valueSet" : ["http://hl7.org/fhir/ValueSet/usps-state"]
    },
    {
      "valueSet" : ["http://hl7.org/fhir/ValueSet/practitioner-specialty"]

      "valueSet" : ["http://terminology.hl7.org/ValueSet/v2-0265"]

    },
    {
      "system" : "http://snomed.info/sct",
      "filter" : [{
        "property" : "concept",
        "op" : "is-a",
        "value" : "394733009"
      }]
    },
    {
      "system" : "urn:iso:std:iso:3166"
    },
    {
      "system" : "urn:iso:std:iso:3166"
    },
    {

      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "filter" : [{
        "property" : "class",
        "op" : "=",
        "value" : "region"
      }]
    },
    {
      "system" : "http://snomed.info/sct",
      "filter" : [{
        "property" : "concept",
        "op" : "is-a",
        "value" : "387961004"
      }]
    },
    {
      "valueSet" : ["http://hl7.org/fhir/ValueSet/administrative-gender"]
    },
    {
      "valueSet" : ["http://hl7.org/fhir/ValueSet/condition-code"]
    },
    {
      "system" : "http://nucc.org/provider-taxonomy"
    },
    {
      "valueSet" : ["http://terminology.hl7.org/ValueSet/v3-ActEncounterCode"]
    },
    {
      "valueSet" : ["http://terminology.hl7.org/ValueSet/v3-ActTaskCode"]
    },
    {
      "valueSet" : ["http://hl7.org/fhir/ValueSet/usage-context-agreement-scope"]

    }]
  }
}

Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.