The Provider Directory API provides supplementary information about Practitioner resources.
Contents
Practitioners may be referenced by multiple FHIR resources. Practitioner resources may contain demographic information (such as name and address) when provided by a source system, but this data may be missing or inaccurate. When possible, HIEBus links individual providers to entries in the NPPES Registry. The Provider Directory lookup enables access to these additional practitioner details when available. You can also use the Provider Directory as a stand-alone repository for finding provider information.
The endpoint for the Provider Directory (referred to below as YOUR_PROVIDER_DIRECTORY_ENDPOINT
) is:
https://[YOUR_CAREEVOLUTION_URL]/api/fhir-providers
/api/fhir
). It only uses FHIR R4 resources, so there are not separate endpoints for each FHIR version.
For example, the provider directory endpoint for the FHIR test server is:
https://fhir.careevolution.com/Master.Adapter1.WebClient/api/fhir-providers
A request explorer can also be used to test provider directory queries.
Although separate from the regular FHIR endpoints, the Provider Directory API utilizes FHIR R4 Resources. A limited set of resources are supported; the two primary ones being:
You can submit read and search requests to the Provider Directory just as you would to other FHIR endpoints.
A limited set of search parameters are supported, described below.
Identifier-based queries to the Provider Directory always use the PROVIDER_DIRECTORY_ID
, not the PRACTITIONER_ID
. See provider identifiers for details.
Queries for individual providers can be made using read/search operations with the Practitioner resource.
To read details for an individual provider, first identify the PROVIDER_DIRECTORY_ID
in the Practitioner resource. See provider identifiers for details.
GET https://[YOUR_PROVIDER_DIRECTORY_ENDPOINT]/Practitioner/[PROVIDER_DIRECTORY_ID]
.
PROVIDER_DIRECTORY_ID
is not the same as the PRACTITIONER_ID
.
To search for an individual provider by NPI, first identify the NPI
in the Practitioner resource. See provider identifiers for details.
GET https://[YOUR_PROVIDER_DIRECTORY_ENDPOINT]/Practitioner?identifier=http://hl7.org/fhir/sid/us-npi|[NPI]
.
You can search by other identifiers (e.g., tax ID) by specifying the appropriate system URI and identifier.
To search for an individual provider by name:
GET https://[YOUR_PROVIDER_DIRECTORY_ENDPOINT]/Practitioner?name=[LAST_NAME]&given=[FIRST_NAME]
.
The response will be an R4 Practitioner resource. For example:
Even though organization providers are not automatically linked to Practitioner resources by HIEBus, you can still use the Provider Directory to find information about these providers from the NPPES Registry. This is done using read/search operations with the Organization resource.
PROVIDER_DIRECTORY_ID
.
To search for an individual provider by NPI, first identify the NPI
in the Practitioner resource. See provider identifiers for details.
GET https://[YOUR_PROVIDER_DIRECTORY_ENDPOINT]/Organization?identifier=http://hl7.org/fhir/sid/us-npi|[NPI]
.
You can search by other identifiers (e.g., tax ID) by specifying the appropriate system URI and identifier. For example, to search by TIN:
GET https://[YOUR_PROVIDER_DIRECTORY_ENDPOINT]/Organization?identifier=urn:oid:2.16.840.1.113883.4.4|[TIN]
.
You can also search for organization providers by name and address using the Organization resource search parameters. For example:
GET https://[YOUR_PROVIDER_DIRECTORY_ENDPOINT]/Organization?name=[PROVIDER_NAME]&address=[PROVIDER_ADDRESS]&address-city=[PROVIDER_CITY]&address-state=[PROVIDER_STATE]&address-postalcode=[PROVIDER_ZIP]
.
Each field is optional, but may increase the specificity of the results when specified.
The response will be an R4 Organization resource. For example: