National Directory of Healthcare Providers & Services (NDH) Implementation Guide
2.0.0-current - ci-build United States of America flag

National Directory of Healthcare Providers & Services (NDH) Implementation Guide, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 2.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-us-ndh/ and changes regularly. See the Directory of published versions

Change Log

Page standards status: Informative

The NDH is developed under the FHIR at Scale Taskforce Project

STU2

Key Description
FHIR-48636 Remove Restriction Profile
FHIR-48637 Remove workflow-based sections - Attestation and Validation & Verification
FHIR-52845 Add SNOMEDCT specialty slicing codes as defined in c80-practice-codes, to PractitionerRole.specialty
FHIR-52873 National Directory of Healthcare Provider and Services (NDH) structure change
FHIR-52874 Add Plan-net Structure Mapping to Mappings section of all NDH profiles
FHIR-49703 extensions context best practice
FHIR-48971 Remove NDH Usage restriction extension
FHIR-52981 Add DirectTrust code systems to Endpoint.connectionType and Endpoint.payloadType value sets; Add DirectTrust Use case
FHIR-48972 improve description on InsurancePlan reference
FHIR-50424 clarity on Must Support
FHIR-49191 base-ext-org-alias-type needs to be specific to Organization.alias context
FHIR-49193 no conformance language on home page (index.html)
FHIR-50425 section names on ndapi-artifacts page
FHIR-50426 mark 3 normative pages as normative
FHIR-53533 Unreferenced Extensions (pre-applied block1)
FHIR-53531 unreferenced SearchParameter (pre-applied block1)
FHIR-52973 NDH scope reduction (pre-applied block1)
FHIR-48969 Remove NDH Digitalcertificate extension
FHIR-49192 multiple issues and inconsistencies with menus and information location need correcting
FHIR-48540 Endpoint- Consolidate ihe-specific connection type and endpoint use case
FHIR-48541 Endpoint connection-type-version should be removed from the extensions
FHIR-51996 Problem with Resource Relationship diagram
FHIR-51997 Problem with All Resources Relationships 2 Diagram
FHIR-52846 Add Slice on OrganizationAffiliation.specialty
FHIR-52875 Remove Careteam Profile -> Add Group
FHIR-53377 VerificationResult Resource and Profile are MAY conformance, but search parameters for VerificationResult references under other Profiles are SHALL
FHIR-53378 Recommendation to combine the seven search parameters for verification-result into one search parameter
FHIR-53380 Should the interaction history-type conformance expectation be lowered from SHALL for resources/profiles
FHIR-53707 Endpoint implementation-guide extension needs Actor
FHIR-53708 Endpoint implementation-guide could be identified by URI, not just codes
FHIR-54130 Improve naming for the ig-publication part of the implementation-guide extension in the NDH Endpoint profile and improve the name of the value set associated with that field.
FHIR-54901 Security of Search/Read may be unconstrained
FHIR-42639 Extension must be added to extension pack first
FHIR-55920 THO contact indicated that all CS / VS in THO should be active. The fact NDH is referring to them is sufficient for them to be active.
FHIR-48635 The concept of the extension on trust-framework is the technical aspects of communicating with that endpoint, and is not the policy side of trust-framework. As such this extension should be renamed.
FHIR-42638 The maturity of these extensions has not yet been proven.
FHIR-46125 Need to review IG support and guidance for representing "deleted" records using period, status or active
FHIR-48973 Remove NDH Verification Status Extension
FHIR-53797 The extension newpatients should be marked Must Support for the PractitionerRole profile to encourage users to populate the extension.
FHIR-55925 Better credential list
FHIR-55943 Group Profile type element is too restricted
FHIR-55595 Add "FHIR API Onboarding Metadata" to NDH
FHIR-55913 insurance-benefit-type move to THO
FHIR-55493 Modify source of ValueSet/CodeSystem for Endpoint.environmentType
FHIR-57083 Add FaCeT credential code; discussed May 11, 2026 tcon
FHIR-56424 The status in the extension NDH Qualification should not be fixed at active.
FHIR-56410 In NDH PractitionerRole.specialty, the binding should be extensible to IndividualQualificationsVS.
FHIR-56408 The resource Group needs to be added to the context of use for the extension NDH Verification Status.
FHIR-56200 Remove big table cross-referencing extensions to profiles; use IG Publisher-provided HTML fragments for each profile, extension, search parameter, code system, and value set. Improved descriptions for all artifacts to be more clear and comprehensive.
FHIR-56133 Some search parameters listed in the CapabilityStatement for Location do not appear on the Location profile page.
FHIR-56109 Search parameters defined in the CapabilityStatement for HealthcareService do not include all search parameters listed in the HealthcareService profile page; refine search parameter narrative on profile pages.
FHIR-56108 The healthcareservice-eligibility search parameter is SHALL, so HealthcareService.eligibility.code should be Must Support in ndh-HealthcareService.
FHIR-55957 create extension ServiceOffered extension to hold types of services offered
FHIR-53796 The practitionerrole-network search parameter is SHALL, so PractitionerRole.extension:network should be Must Support in the StructureDefinition.
FHIR-53795 The individual-gender search parameter is SHALL, so Practitioner.gender should be Must Support.
FHIR-48977 Removal of contactpoint-availabletime and via-intermediary extensions.
FHIR-48970 Removal of NDH Qualification extension.
FHIR-48638 Clarify and add example of Organization-Rating extension.
FHIR-52859 Update PractitionerRole.extension[network] from 0..1 to 0..*.
FHIR-56052 Drop the network parameter on OrganizationAffliation from SHALL to SHOULD.