Provider Directory API
Resolve an NPI to the practitioner behind it, find practitioners and networks in CMS's National Provider Directory, and find pharmacies in CMS's NPI Registry.
The haau3 platform API is in preview: it may change as we build, usually to add features or improve performance. Every API open to customers today is included in every plan. Free to start on the Developer plan.
Request
GET /v1/fhir/r4/Practitioner
?identifier=<npi>Response
{
"resourceType": "Bundle",
"type": "searchset",
"entry": [
{
"resource": {
"resourceType": "Practitioner",
"name": [{ "family": "<family>",
"given": ["<given>"] }],
"qualification": [
{ "code": { "text": "<specialty>" } }
]
}
}
]
}What it does
- Resolve an NPI to a name, credentials, specialties and practice locations
- Find a practitioner by name, narrowed by city or state
- Search roles at an organisation or location, narrowed by specialty
- List payers and insurance networks, and the organisations a network lists
- Find pharmacies by state and ZIP code or city, by kind, with each one’s NPI and store address
- Send the NPI system you already use. All the common forms are accepted
- Follow a practitioner to their roles, and a role to its organisation and locations
- Standard FHIR: the directory's records as it publishes them, and pharmacies built from the NPI Registry
- An empty result means the directory holds no matching record, never that the lookup failed
Built on
You already hold NPIs. This resolves each one to the practitioner behind it, along with the organisations, specialties and practice locations they work under, backed by the CMS National Provider Directory and served as standard FHIR. When you only have a name, search by it, narrowed by city or state. Search the roles at an organisation or location by specialty, list the payers and insurance networks the directory holds, and see which organisations a network lists.
Start building today
Detailed developer docs live at docs.haau3.com.
Open-source SDKs for TypeScript, Python and Go cover every endpoint. SDK docs
Try it with no account: the documented example answers at sandbox.haau3.com, the API's test environment. About the Sandbox