# NDH Practitioner Profile - National Directory of Healthcare Providers & Services (NDH) Implementation Guide v2.0.0-current

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **NDH Practitioner Profile**

## Resource Profile: NDH Practitioner Profile 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Practitioner | *Version*:2.0.0-current | |
| * Standards status: *[Trial-use](http://hl7.org/fhir/R4/versions.html#std-process) | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 4 | *Computable Name*:NdhPractitioner |

 
Practitioner is a person who is directly or indirectly involved in the provisioning of healthcare. 

**Usages:**

* Refer to this Profile: [NDH Group](StructureDefinition-ndh-Group.md), [NDH PractitionerRole](StructureDefinition-ndh-PractitionerRole.md) and [NDH Verification](StructureDefinition-ndh-Verification.md)
* Examples for this Profile: [Practitioner/HansSolo](Practitioner-HansSolo.md), [Practitioner/JoeSmith](Practitioner-JoeSmith.md), [Practitioner/PractitionerOneWithNetwork1AndNetwork2](Practitioner-PractitionerOneWithNetwork1AndNetwork2.md) and [Practitioner/PractitionerTwoWithNetwork1LeftAfterSixMonths](Practitioner-PractitionerTwoWithNetwork1LeftAfterSixMonths.md)
* CapabilityStatements using this Profile: [NDH Server Capability Statement](CapabilityStatement-ndh-server.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.us.ndh|current/StructureDefinition/ndh-Practitioner)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-ndh-Practitioner.csv), [Excel](StructureDefinition-ndh-Practitioner.xlsx), [Schematron](StructureDefinition-ndh-Practitioner.sch) 

### Notes:

### Search Parameters

#### Search Parameter defined by the NDH IG

| | | |
| :--- | :--- | :--- |
| [qualification-issuer](SearchParameter-practitioner-qualification-issuer.md) | reference | `GET [base]/Practitioner?qualification-issuer.name=Florida License Board` |
| [qualification-code](SearchParameter-practitioner-qualification-code.md) | token | `GET [base]/Practitioner?qualification-code=MD` |
| [endpoint](SearchParameter-practitioner-endpoint.md) | reference | `GET [base]/Practitioner?endpoint.identifier={system}|{value}` |
| [verification-status](SearchParameter-verification-status.md) | token | `GET [base]/Practitioner?verification-status=complete` |

#### Search Parameter defined by FHIR Search Parameter Registry and used by the NDH IG

* [Search Parameter Registry](https://hl7.org/fhir/R4/searchparameter-registry.html)
* [Practitioner Search Parameter from Registry](https://hl7.org/fhir/R4/practitioner.html#search)

| | | |
| :--- | :--- | :--- |
| active | token | `GET [base]/Practitioner?active=true` |
| name | string | `GET [base]/Practitioner?name=Joe Smith` |
| gender | token | `GET [base]/Practitioner?gender=male` |
| identifier | token | `GET [base]/Practitioner?identifier=12345678` |

#### _include Search Parameter

| | |
| :--- | :--- |
| Practitioner:endpoint | `GET [base]/Practitioner?_include= Practitioner:endpoint` |
| Practitioner:qualification-issuer | `GET [base]/Practitioner?_include=Practitioner:qualification-issuer` |

#### _revinclude Search Parameter

| |
| :--- |
| PractitionerRole:practitioner |



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "ndh-Practitioner",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "pa"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 4,
    "_valueInteger" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/us/ndh/ImplementationGuide/hl7.fhir.us.ndh"
      }]
    }
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use",
    "_valueCode" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/us/ndh/ImplementationGuide/hl7.fhir.us.ndh"
      }]
    }
  }],
  "url" : "http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Practitioner",
  "version" : "2.0.0-current",
  "name" : "NdhPractitioner",
  "title" : "NDH Practitioner Profile",
  "status" : "active",
  "date" : "2026-03-23T21:58:05+00:00",
  "publisher" : "HL7 International / Patient Administration",
  "contact" : [{
    "name" : "HL7 International / Patient Administration",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/pafm"
    },
    {
      "system" : "email",
      "value" : "pafm@lists.hl7.org"
    }]
  }],
  "description" : "Practitioner is a person who is directly or indirectly involved in the provisioning of healthcare.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US",
      "display" : "United States of America"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "ndh-to-plannet-practitioner",
    "uri" : "http://hl7.org/fhir/us/davinci-pdex-plan-net",
    "name" : "NDH to Plan-Net Practitioner Mapping",
    "comment" : "Maps NDH Practitioner profile to the Plan-Net Practitioner profile, noting elements not present in Plan-Net."
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "servd",
    "uri" : "http://www.omg.org/spec/ServD/1.0/",
    "name" : "ServD"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Practitioner",
  "baseDefinition" : "http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner|6.1.0",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Practitioner",
      "path" : "Practitioner",
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Practitioner",
        "comment" : "Top-level mapping from NDH to Plan-Net"
      }]
    },
    {
      "id" : "Practitioner.meta.lastUpdated",
      "path" : "Practitioner.meta.lastUpdated",
      "min" : 1,
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Practitioner.meta.lastUpdated",
        "comment" : ", is required in NDH"
      }]
    },
    {
      "id" : "Practitioner.extension",
      "path" : "Practitioner.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Practitioner.extension:us-core-race",
      "path" : "Practitioner.extension",
      "sliceName" : "us-core-race",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-race|6.1.0"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.extension:us-core-ethnicity",
      "path" : "Practitioner.extension",
      "sliceName" : "us-core-ethnicity",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity|6.1.0"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.extension:individual-genderIdentity",
      "path" : "Practitioner.extension",
      "sliceName" : "individual-genderIdentity",
      "min" : 0,
      "max" : "0",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/individual-genderIdentity|5.2.0"]
      }]
    },
    {
      "id" : "Practitioner.extension:individual-pronouns",
      "path" : "Practitioner.extension",
      "sliceName" : "individual-pronouns",
      "min" : 0,
      "max" : "0",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/individual-pronouns|5.2.0"]
      }]
    },
    {
      "id" : "Practitioner.extension:individual-recordedSexOrGender",
      "path" : "Practitioner.extension",
      "sliceName" : "individual-recordedSexOrGender",
      "min" : 0,
      "max" : "0",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/individual-recordedSexOrGender|5.2.0"]
      }]
    },
    {
      "id" : "Practitioner.extension:endpoint",
      "path" : "Practitioner.extension",
      "sliceName" : "endpoint",
      "short" : "Endpoint Reference",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-endpoint-reference"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.extension:accessibility",
      "path" : "Practitioner.extension",
      "sliceName" : "accessibility",
      "short" : "Accessibility",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-accessibility"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.extension:rating",
      "path" : "Practitioner.extension",
      "sliceName" : "rating",
      "short" : "Rating",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-rating"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.extension:cms-enrollment-in-good-standing",
      "path" : "Practitioner.extension",
      "sliceName" : "cms-enrollment-in-good-standing",
      "short" : "CMS Enrollment In Good Standing",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-cms-enrollment-in-good-standing"]
      }]
    },
    {
      "id" : "Practitioner.extension:cms-ial2-verified",
      "path" : "Practitioner.extension",
      "sliceName" : "cms-ial2-verified",
      "short" : "CMS IAL2 Verified",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-cms-ial2-verified"]
      }]
    },
    {
      "id" : "Practitioner.extension:aligned-with-cms-data-network",
      "path" : "Practitioner.extension",
      "sliceName" : "aligned-with-cms-data-network",
      "short" : "Aligned with CMS Data Network",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-aligned-with-cms-data-network"]
      }]
    },
    {
      "id" : "Practitioner.extension:verification-status",
      "path" : "Practitioner.extension",
      "sliceName" : "verification-status",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-verification-status"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.identifier",
      "path" : "Practitioner.identifier",
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Practitioner.identifier"
      }]
    },
    {
      "id" : "Practitioner.identifier.extension:identifier-status",
      "path" : "Practitioner.identifier.extension",
      "sliceName" : "identifier-status",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.identifier.assigner",
      "path" : "Practitioner.identifier.assigner",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"]
      }]
    },
    {
      "id" : "Practitioner.active",
      "path" : "Practitioner.active",
      "min" : 1,
      "patternBoolean" : true
    },
    {
      "id" : "Practitioner.name.text",
      "path" : "Practitioner.name.text",
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.telecom.extension:contactpoint-availabletime",
      "path" : "Practitioner.telecom.extension",
      "sliceName" : "contactpoint-availabletime",
      "min" : 0,
      "max" : "*",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-contactpoint-availabletime"]
      }]
    },
    {
      "id" : "Practitioner.telecom.extension:via-intermediary",
      "path" : "Practitioner.telecom.extension",
      "sliceName" : "via-intermediary",
      "short" : "Via Intermediary",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-via-intermediary"]
      }]
    },
    {
      "id" : "Practitioner.address.extension:geolocation",
      "path" : "Practitioner.address.extension",
      "sliceName" : "geolocation",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/StructureDefinition/geolocation|4.0.1"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.address.state",
      "path" : "Practitioner.address.state",
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/us/core/ValueSet/us-core-usps-state|6.1.0"
      }
    },
    {
      "id" : "Practitioner.qualification",
      "path" : "Practitioner.qualification",
      "mustSupport" : true,
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Practitioner.qualification"
      }]
    },
    {
      "id" : "Practitioner.qualification.extension",
      "path" : "Practitioner.qualification.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Practitioner.qualification.extension:practitioner-qualification",
      "path" : "Practitioner.qualification.extension",
      "sliceName" : "practitioner-qualification",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-practitioner-qualification"]
      }]
    },
    {
      "id" : "Practitioner.qualification.identifier.extension:identifier-status",
      "path" : "Practitioner.qualification.identifier.extension",
      "sliceName" : "identifier-status",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-identifier-status"]
      }],
      "mapping" : [{
        "identity" : "ndh-to-plannet-practitioner",
        "map" : "Not in Plan-Net",
        "comment" : ", NDH-specific"
      }]
    },
    {
      "id" : "Practitioner.qualification.identifier.assigner",
      "path" : "Practitioner.qualification.identifier.assigner",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"]
      }]
    },
    {
      "id" : "Practitioner.qualification.code",
      "path" : "Practitioner.qualification.code",
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/us/ndh/ValueSet/IndividualSpecialtyAndDegreeLicenseCertificateVS"
      }
    },
    {
      "id" : "Practitioner.qualification.issuer",
      "path" : "Practitioner.qualification.issuer",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/ndh-Organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Practitioner.communication.extension:communication-proficiency",
      "path" : "Practitioner.communication.extension",
      "sliceName" : "communication-proficiency",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/ndh/StructureDefinition/base-ext-communication-proficiency"]
      }]
    }]
  }
}

```
