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

National Directory API Examples

Page standards status: Informative

Social Service

Social Service diagram for example

HealthcareService Towson FoodOrganization SocialTowson FoodLocation SocialTowson FoodHealthcareService Hope CBOOrganization Hope CBOLocation Hope CBOprovidedByprovided atmanagingOrganizationprovidedByprovided atmanagingOrganization

Social Service Examples

PractitionerRole

PractitionerRole 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.

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 diagram for example

PractitionerRole: HansSoloRolePractitioner: HansSoloLocation: HansSoloClinicHealthcareService: HansSoloServiceInsurancePlan: BlueCrossBlueShield-CTNetwork: BlueCrossBlueShield-CT-PPOOrganization: BlueCrossBlueShield-CT-ORGEndpoint: HansSoloDirectTrustEndpointReferralsEndpoint: HansSoloPatientAccessEndpointpractitionerspecialtyhealthcareServicenetworklocationendpointendpointnetworkpartOfownedBy

Examples associated with this PractitionerRole

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.

Use Case Relationship Diagram

NetworkNetwork1NetworkNetwork2OrganizationOrganization Manage the NetworkPractitionerPractitionerParicipating inBoth Network1 and Network2PractitionerRolePractitionerRole forPractitioner and Network1PractitionerRolePractitionerRole forPractitioner and Network2InsurancePlanMedicare AdvantageInsurancePlanHMOMedicare Advantage HMOpartOfpartOf

Examples associated with this Use Case Relationship Diagram

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.

OrganizationAffiliation and Networks Use Case Relationship Diagram

Network1Network2OrgManageNetworkOrgOneWithNetwork1AndNetwork2OrgOneNetwork1AffiliationOrgOneNetwork2AffiliationInsurancePlanMedicare AdvantageInsurancePlanMedicare Advantage HMO

Examples associated with OrganizationAffiliation and Networks Use Case Relationship Diagram

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.

HealthcareService and Networks without InsurancePlan Use Case Relationship Diagram

SocialServiceHousingNetworkHealthcareServiceHomelessAssistanceLocationWelcomeHomeOrganizationWelcomeHomeOrganizationManageHousingNetwork

Examples associated with HealthcareService and Networks without InsurancePlan

OrganizationAffiliation

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]locationprovidedBymanagingOrganization
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