Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Short Description

Review and test aspects of the ONC FAST National Directory of Healthcare & Da Vinci Plan Net

Long Description

Review of the existing implementation guides that are part of input into the FAST Directory solution.  The existing implementation guides include the National Directory Exchange IG, the Endpoint Query IG and the Attestation and Validation IG. The FAST solution document outlines the direction that will be taken in creating the three new IGs that are part of the National Directory work effort at HL7.

The goal of the project is to create FHIR based standards for:

1) The exchange of validated healthcare directory information in a federated access environment based on the Validated Healthcare Directory standard localized for the US Realm using work completed for the PDex Plan Net FHIR IG (includes 11-14 in drawing below),

2) Query for FHIR endpoints from any federated directory instance (includes 15-16 in the drawing below), and

3) Submitting attested information to the validated directory and verifying the information against primary sources (includes 1-10 in drawing below).

This project is needed to provide standards for the population, validation, exchange and query of a federated access national healthcare directory.  It will:

  1. Minimize the burden on providers in supplying this information to multiple payers, healthcare organizations, and professional societies
  2. Improve the quality of demographic and relationship information associated with healthcare organizations and individuals,
  3. Provide a reliable source of electronic endpoints to facilitate the exchange of healthcare information (e.g. patient records and referrals).  In particular, the standards will facilitate the creation, population, and use of a national resource to support the scaling of FHIR based exchanges to support more efficient and better informed delivery of health care services.

Project Page:

Plan Net enables patients/consumers to see which providers and pharmacies are in-network for a given organization insurance plan.

These implementation guides are recommended by CMS as one way to comply with the  Patient Access API rule.

This track will continue the work of previous connectathon tracks and focus on testing:

Plan-Net IG:

  • The Plan Net profiles and Endpoints
  • General health care service, provider, and pharmacy search
  • Pharmacy mix
  • Ability to manage provider directory list for incoming/outgoing providers


Review initial implementation guide work and test associated reference implementations and third party software

Track Lead(s)

Track Lead Email(s);

Related Tracks

2023 - 01 FAST Infrastructure (Security, Identity, Directory, Exchange) - FHIR - Confluence (

CMS 2022 - 07 Da Vinci Payer Data Exchange Drug Formulary and Plan-Net

Specification Information

The FAST Directory Track will use both of the following IG as reference information

National Directory Exchange FHIR IG:

National Directory Endpoint Query FHIR IG:

National Directory Attestation and Validation FHIR IG:

Reference Implementations

National Directory Reference Implementation (Validation / Attestation / UDAP)

PDex Plan Net Reference Implementation

Call for participants

Payers and Providers interested in using an endpoint directory to facilitate implementing the CMS and ONC final rules

National Directory Planning Calls

Zulip stream

Zulip stream for comments and questions regarding the ONC FAST Directory Track

Track Kick-off Call



  1. Have read the National Directory and Plan Net IGs (linked above)
  2. Have registered for an account on Touchstone (reach out to one of the leads if you need help with this)
  3. FHIR Client

    Come prepared to interact with a FHIR Server.  This can be accomplished with an application that can be configured or coded to make FHIR RESTful calls.  See the "Step by step tutorial and sample projects" under the Helpful Links below for an example of how to do this use Postman.

    FHIR Server

    Come prepared for other FHIR Clients to be able to interact with your FHIR Server.

Testing Scenario:

Role 1 Name: National Directory Actor

Role 2 Name: Distributed Access/Workflow Directory

Role 2 Name: Application Query Actor

Use Case 1- Query the Distributed Access/Workflow Directory for a specific endpoint based on the name or ID of a payer organization

Scenario Step 1 Connect to Distributed Access/Workflow Directory API endpoint

Action: Query Federated Directory Endpoint

Success Criteria:  ability to access a Federated Directory API 

Scenario Step 2 Query for endpoint information for a specific Payer

Action: RESTful GET of endpoint information for a specific Payer organization

Success Criteria:  ability to return endpoint information for a specific payer organization

Scenario Step 3 Query Bulk Data endpoint 

Action: RESTful GET of streaming NDJSON file 

Success Criteria:  ability to return bulk data stream for a specific resource

Stretch Goal:  ability to query NDJSON bulk data from IPFS or BitTorrent 


Security and Privacy Considerations:

FAST UDAP Security protocols required for some use case exchanges.

Plan-Net IG:

  • General Search
  • Provider Search
  • Pharmacy Search
  • Pharmacy Mix
  • Plan Net Bulk Export

System roles:

      • Payer acting as Server
      • Third-Party App acting as Client

Role 1 Name: Server 

Server provides $export operation to enable Payer Provider Directory to be exported.

Role 2 Name: Client

Client makes $export request to download Payer Provider Directory.


Touchstone Tests are found at: