National Directory of Healthcare Providers & Services (NDH) Implementation Guide
1.0.0-ballot - ballot 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 1.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of and changes regularly. See the Directory of published versions

National Directory API Examples

Exchange Examples

Social Service

Social Service diagram for example
HealthcareService Towson FoodOrgnization SocialTowson FoodLocation SocialTowson FoodHealthcareService Hope CBOOrgnization Hope CBOLocation Hope CBOprovidedByprovided atmanagingOrganizationprovidedByprovided atmanagingOrganization


PractionerRole describes the relationship between a practitioner and an organization. A practitioner provides services to the organization at a location. Practitioners also participate in healthcare provider insurance networks through their role at an organization.

Examples associated with this PractiontionerRole

Dr. Hans Solo operates a private practice within the Hans Solo Clinic, offering primary healthcare services. He is an active participant in the Blue Cross Blue Shield Connecticut PPO network, which is covered by the Blue Cross Blue Shield Connecticut Insurance Plan.

Patients can effortlessly locate Dr. Solo by searching his name, specialty, or location. The search results provide comprehensive information, including the location and type of service offered, the clinic’s working hours, acceptance of new patients, types of insurance honored, and an electronic link to access patient medical records.

Other healthcare organizations also have the ability to access Dr. Solo’s practice endpoint, providing a secure route to patient medical records or to transmit referral details.

Moreover, the Blue Cross Blue Shield PPO Network can utilize Dr. Solo’s practice endpoint to retrieve patient medical data for claim processing and pre-authorization procedures.

PractitionerRole: HansSoloRolePractitioner: HansSoloLocation: HansSoloClinicHealthcareService: HansSoloServiceInsurancePlan: BlueCrossBlueShield-CTNetwork: BlueCrossBlueShield-CT-PPOOrganization: BlueCrossBlueShield-CT-ORGEndpoint: HansSoloDirectTrustEndpointReferralsEndpoint: HansSoloPatientAccessEndpointpractitionerhealthcareServicenetworklocationendpointendpointnetworkpartOfownedBy
Practitioner and Networks.

Practitioners have the flexibility to engage in multiple insurance networks concurrently. They are also afforded the liberty to disengage from a network or integrate into a new one. The NDH has established infrastructure, utilizing PractitionerRole, to facilitate these transitions.

In the duration from June 1, 2023, to December 31, 2023, a practitioner, referred to as Network1andNetwork2 PractitionerOne, is actively involved in both the Network1 and Network2, under the administration of OMPN, an organization responsible for managing payer networks.

However, by the end of 2023, the practitioner plans to withdraw from Network1. Meanwhile, the practitioner commenced their affiliation with Network2 on June 1, 2023.

NetworkNetwork1NetworkNetwork2OrganizationOrganization Manage the NetworkPractitionerPractitionerParicipating inBoth Network1 and Network2PractitionerRolePractitionerRole forPractitioner and Network1PractitionerRolePractitionerRole forPractitioner and Network2InsurancePlanMedicare AdvantageInsurancePlanMedicare Advantage HMOpartOfpartOf
OrganizationAffliliation and Networks.

Organizations could participate in several insurance networks simultaneously. They possess the freedom to disconnect from an existing network or assimilate into a new one. The NDH has crafted an infrastructure, through OrganizationAffiliation, to streamline such transitions.

From June 1, 2023, through December 31, 2023, an organization named OrgOneWithNetwork1AndNetwork2 is actively engaged with both the Network1 and Network2 networks. This participation is supervised by OMPN, an entity tasked with overseeing payer networks.

Nevertheless, by the close of 2023, the organization anticipates severing its ties with the Network1 network. Concurrently, the organization initiated its association with the Network2 network starting on June 1, 2023.

Network1Network2OrgManageNetworkOrgOneWithNetwork1AndNetwork2OrgOneNetwork1AffiliationOrgOneNetwork2AffiliationInsurancePlanMedicare AdvantageInsurancePlanMedicare Advantage HMO
HealthcareService and Networks without InsurancePlan

Typically, healthcare service networks are tied to insurance plans. However, in the realm of social services, the delivery or subscription of services often occurs through a hub. This hub embodies a similar concept to a network, but without an insurance plan attached. To simplify the process of locating such hubs (networks), NDH offers a connection from the healthcare server to the network. For instance, the Welcome Home organization provides housing services at the Welcome Home location. This service is subscribed to through the Social Service Housing Network.



Similar to PractitionerRole, OrganizationAffiliation describes relationships between organizations.

OrganizationAffiliation among clinic, hospital, network, and insurance plan
OrganizationAffiliation relationship diagram for example
OrganizationAffiliation: OrganizationAffiliation/BurrClinicAffilOrganization: Organization/BurrClinicNetwork: Organization/AcmeofCTStdNetOrganization: Organization/AcmeOrganization Organization/HospitalNetwork: Organization/AcmeofCTPremNetLocation: Location/HospLoc1Location: Location/HospLoc2Location: Location/StateOfLocationHealthcareService: HealthcareService/BurrClinicServicesInsurancePlan: InsurancePlan/AcmeQHPGoldEndpoint: Endpoint/AcmeOfCTPortalEndpointorganizationparticipatingOrganizationnetworklocationhealthcareServicepartOfpartOfnetwork[0]coverageAreaendpointadministeredByownedBynetwork[1]locationprovidedBymanagingOrgnization
Examples associated with this OrganizationAffiliation
OrganizationAffiliation among pharmacy chain
Pharmacy chain OrganizationAffiliation relationship diagram for example
OrganizationAffiliation: OrganizationAffiliation/PharmChainAffil1Organization: Organization/PharmChainNetwork: Organization/AcmeofCTStdNetOrganization: Organization/BigBoxOrganization: Organization/AcmeLocation: Location/PharmLoc1Location: Location/PharmLoc2Location: Location/PharmLoc3Location: Location/PharmLoc4HealthcareService: HealthcareService/PharmChainRetailServiceparticipatingOrganizationnetworklocation[1]partOflocation[0]healthcareServiceextension.fromNetworkmanagingOrganizationextension.fromNetworkmanagingOrganizationlocation[3]location[2]Location[1]location[0]provideByextension.fromNetwork
Examples associated with this OrganiztionAffiliation