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 OrganizationAffiliation from SHALL to SHOULD.
FHIR‑56331 Modify CMS extensions
FHIR‑56270 Missing Example including Group.extension[verification-status]
FHIR‑56338 Remove endpoint extension from Practitioner Resource
FHIR‑56339 Explain how to use Search on a given Practitioner to find all their endpoints with context
FHIR‑57355 Remove EndpointTestingCertification extension l
FHIR‑57424 Add contact:configuration‑url slice to NDH Endpoint from SMART UAB
FHIR‑57425 Make OAuth codes more specific
FHIR‑56395 Make insurance‑benefit‑type local codeSystem
FHIR‑56269 Remove unnecessary IG dependencies
FHIR‑53794 Include Security conformance from the IG in the CapabilityStatement
FHIR‑48976 Removal of NDH Organization Alias Type Extension
FHIR‑56268 NDH Payment Accepted extension version pinning cleanup
FHIR‑57084 NUCC valueset logic implementation
FHIR‑56053 OrganizationAffiliation.network search parameter SHOULD instead of SHALL