FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions . Page versions: R5 R4B R4 R3

Valueset-provider-taxonomy.json

Example ValueSet/provider-taxonomy (JSON)

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

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

Definition for Value SetProvider Taxonomy Codes

{
  "resourceType": "ValueSet",
  "id": "provider-taxonomy",
  "meta": {
    "lastUpdated": "2019-10-24T11:53:00+11:00",
    "profile": [
      "http://hl7.org/fhir/StructureDefinition/shareablevalueset"
    ]

  "resourceType" : "ValueSet",
  "id" : "provider-taxonomy",
  "meta" : {
    "lastUpdated" : "2025-11-10T15:17:08.817+00:00"

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

  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ValueSet provider-taxonomy</b></p><a name=\"provider-taxonomy\"> </a><a name=\"hcprovider-taxonomy\"> </a><ul><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></ul></div>"

  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-ballot-status",
      "valueString": "Informative"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 0
    }
  ],
  "url": "http://hl7.org/fhir/ValueSet/provider-taxonomy",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.3.902"
    }
  ],
  "version": "3.0.2",
  "name": "Provider Taxonomy Codes",
  "status": "draft",
  "experimental": true,
  "date": "2019-10-24T11:53:00+11:00",
  "publisher": "FHIR Project team",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://hl7.org/fhir"
        }
      ]
    }
  ],
  "description": "NUCC Healthcare Provider Taxonomy codes",
  "copyright": "The NUCC Health Care Provider Taxonomy codes are copyright © 2017, American Medical Association.",
  "compose": {
    "include": [
      {
        "system": "http://nucc.org/provider-taxonomy"
      }
    ]

  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "vocab"
  }],
  "url" : "http://hl7.org/fhir/ValueSet/provider-taxonomy",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.3.51"
  }],
  "version" : "6.0.0-ballot3",
  "name" : "ProviderTaxonomyCodes",
  "title" : "Provider Taxonomy Codes",
  "status" : "draft",
  "experimental" : true,
  "date" : "2025-11-10T15:17:08+00:00",
  "publisher" : "HL7 International / Terminology Infrastructure",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"
    }]
  },
  {
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/Vocab"
    }]
  }],
  "description" : "NUCC Healthcare Provider Taxonomy codes",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "copyright" : "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" : [{
      "system" : "http://nucc.org/provider-taxonomy"
    }]

  }
}

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.