National Provider Identifier Lookup & Search Tool avatar

National Provider Identifier Lookup & Search Tool

Pricing

from $0.49 / 1,000 results

Go to Apify Store
National Provider Identifier Lookup & Search Tool

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

Dataspryva

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

4 hours ago

Last modified

Features

Limited permissions

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 Identifier
  • entityType — individual or organization
  • firstName, lastName — individual provider's name
  • organizationName — organization name
  • credential — professional credential (e.g. MD, DO, NP)
  • gender — M or F, for individual providers
  • primarySpecialty — the provider's primary taxonomy/specialty
  • specialties — every taxonomy/specialty on file for the provider
  • practiceAddress, practiceCity, practiceState, practiceZip — practice location
  • practicePhone — practice phone number
  • mailingAddress, mailingCity, mailingState — mailing address, when it differs from practice
  • enumerationDate — the date the NPI was first issued
  • certificationDate — date of the most recent certification or update
  • status — A (active) or D (deactivated)
  • url — the provider's public registry profile page
  • scrapedAt — when the record was fetched

Input

FieldTypeDefaultDescription
modestringsearchProviderssearchProviders, lookupByNPI, searchBySpecialty, or searchByOrganization
firstNamestring–Provider first name (modes searchProviders, searchBySpecialty)
lastNamestring–Provider last name (modes searchProviders, searchBySpecialty)
organizationNamestring–Organization or group name (mode searchByOrganization)
npiNumberstring–Exact 10-digit NPI to resolve (mode lookupByNPI)
specialtyDescriptionstring–Free-text specialty/taxonomy to filter by, e.g. Cardiology
statestring–Two-letter US state code to filter providers by
citystring–City name to filter providers by
postalCodestring–5-digit US ZIP code to filter providers by
enumerationTypestring–NPI-1 (individuals), NPI-2 (organizations), or leave blank for both (mode searchProviders)
maxItemsinteger50Maximum 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.