Find a practitioner by NPI or name
Search Practitioner by identifier to resolve an NPI you already hold, or by name to find someone. A search needs one or the other: address-city and address-state narrow a name search but cannot stand alone. Searching by specialty is not offered.
Three identifier systems are accepted — http://terminology.hl7.org/NamingSystem/npi, http://hl7.org/fhir/sid/us-npi and urn:oid:2.16.840.1.113883.4.6 — as well as a bare 10-digit value. All are searched as the system the directory indexes, so responses carry that system rather than the one you sent. Any other identifier system is refused by name: a system the directory does not index would answer with an empty result, which reads as ‘no such provider’.
One NPI per search. To resolve several, POST a batch Bundle with one entry each.
Authorizations
Your platform API key (haau3_sk_…), sent as Authorization: Bearer <key>.
Query Parameters
{system}|{npi} or a bare 10-digit NPI. Required unless page is given.
Matches across the whole name.
The family name. Required unless identifier, name, given or page is given.
A given name.
Narrows a name search. Matches any of the practitioner's addresses, so a result can still list addresses in other cities. Cannot be used on its own.
Narrows a name search. Matches any of the practitioner's addresses, so a result can still list addresses in other states. Cannot be used on its own.
Include the practitioner's roles in the same bundle. Included entries do not count toward _count.
PractitionerRole:practitioner Page size, 1 to 100. A larger value is refused rather than quietly reduced.
1 <= x <= 100Continuation cursor. Opaque — follow the next link from a previous response; never construct or modify it. Cursors expire.
Response
A FHIR Bundle with type: searchset. Entries carry fullUrls and links on this service. No total is returned, because the directory does not provide one.
The response is of type object.