National Provider Identifier Lookup & Search Tool
Pricing
from $0.49 / 1,000 results
National Provider Identifier Lookup & Search Tool
Search US healthcare providers and organizations by name, state, city, ZIP, or specialty, or look up an exact National Provider Identifier number, and get practice address, phone, credentials, and status.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
Dataspryva
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 hours ago
Last modified
Categories
Features
Share
Look up US healthcare providers and organizations the way medical billing, credentialing, and verification teams already do — by their 10-digit National Provider Identifier (NPI), or by name, location, and specialty. This actor reads the federal public registry that assigns NPIs to every individual provider and healthcare organization in the United States.
What this actor does
- Four search modes: search individual providers, resolve one exact NPI number, search by specialty/taxonomy, or search organizations
- Location narrowing: filter by state, city, and ZIP code on any search mode
- Full contact detail: practice and mailing addresses, phone number, and credential/specialty data per provider
- Both entity types: individual providers (NPI-1) and organizations (NPI-2), filterable via
enumerationType - Empty fields are omitted — a provider record only includes the fields that registry actually has on file for them
Output per provider
npi— the 10-digit National Provider IdentifierentityType—individualororganizationfirstName,lastName— individual provider's nameorganizationName— organization namecredential— professional credential (e.g.MD,DO,NP)gender—MorF, for individual providersprimarySpecialty— the provider's primary taxonomy/specialtyspecialties— every taxonomy/specialty on file for the providerpracticeAddress,practiceCity,practiceState,practiceZip— practice locationpracticePhone— practice phone numbermailingAddress,mailingCity,mailingState— mailing address, when it differs from practiceenumerationDate— the date the NPI was first issuedcertificationDate— date of the most recent certification or updatestatus—A(active) orD(deactivated)url— the provider's public registry profile pagescrapedAt— when the record was fetched
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode | string | searchProviders | searchProviders, lookupByNPI, searchBySpecialty, or searchByOrganization |
firstName | string | – | Provider first name (modes searchProviders, searchBySpecialty) |
lastName | string | – | Provider last name (modes searchProviders, searchBySpecialty) |
organizationName | string | – | Organization or group name (mode searchByOrganization) |
npiNumber | string | – | Exact 10-digit NPI to resolve (mode lookupByNPI) |
specialtyDescription | string | – | Free-text specialty/taxonomy to filter by, e.g. Cardiology |
state | string | – | Two-letter US state code to filter providers by |
city | string | – | City name to filter providers by |
postalCode | string | – | 5-digit US ZIP code to filter providers by |
enumerationType | string | – | NPI-1 (individuals), NPI-2 (organizations), or leave blank for both (mode searchProviders) |
maxItems | integer | 50 | Maximum number of provider records to return (1–2000) |
Example: search individual providers by name and state
{"mode": "searchProviders","firstName": "John","lastName": "Smith","state": "CA","maxItems": 50}
Example: resolve an exact NPI number
{"mode": "lookupByNPI","npiNumber": "1234567890"}
Example: search by specialty within a state
{"mode": "searchBySpecialty","specialtyDescription": "Cardiology","state": "NY","maxItems": 100}
Example: search for an organization by name
{"mode": "searchByOrganization","organizationName": "Mayo Clinic","state": "MN"}
Use cases
- Healthcare lead generation — build lists of providers or organizations by state and specialty
- Provider directory maintenance — refresh practice addresses and contact details against the registry
- NPI verification — confirm a provider's NPI, status, and credentials before onboarding or billing
- Specialty market mapping — see how many providers of a given specialty practice in a state or city
- Research and analytics — study provider distribution across geography and specialty
FAQ
Is this affiliated with CMS or the federal government? No. This is an independent, third-party actor that reads the publicly available NPI registry data; it is not affiliated with or endorsed by the Centers for Medicare & Medicaid Services.
What is an NPI number? A National Provider Identifier is a unique 10-digit number assigned to every individual healthcare provider and healthcare organization in the US, required for HIPAA-covered transactions like insurance claims.
Do I need a login or API key? No. The registry this actor reads is a free public database with no authentication required.
Can I search for hospitals and clinics instead of individuals?
Yes — use mode: "searchByOrganization" with organizationName to search group practices, hospitals, pharmacies, and other organizations.
Why are some fields missing on a provider record? Not every provider's registration includes every field — older records in particular may lack a credential, phone number, or mailing address. The actor leaves those fields out rather than sending an empty value.
Can I filter by ZIP code or city instead of state?
Yes. city and postalCode work alongside state on every mode except lookupByNPI, which resolves a single exact record.
What's the difference between primarySpecialty and specialties?
primarySpecialty is the provider's main taxonomy classification. specialties lists every taxonomy/specialty on file for that provider, which can include more than one.
How current is the data? The registry is updated regularly with new registrations and address changes, and each run reads it live, so results reflect what's published at run time.