NPI Healthcare Provider Directory (NPPES)

Search the official CMS NPPES NPI Registry and get one flat row per US healthcare provider: NPI, name, credential, primary specialty and taxonomy code, license number and state, practice address, phone, fax, enumeration date, last update and status, plus the link to the provider's registry page.

The registry itself stops at 1,200 results per search. This actor does not. When a search hits that cap it splits the query automatically (by ZIP prefix, then by provider type, then by last-name prefix), merges the pieces and removes duplicates by NPI, so "all dentists in Texas" returns the whole list instead of the first 1,200.

Data comes only from the public registry. Only the practice location the registry publishes is returned (not the mailing address), and nothing is enriched from other sources.

Input

Field	What it does	Example
taxonomy	Specialty text matched against NPPES taxonomy descriptions. One per line.	Dentist, Cardiology, Pharmacy
states	2-letter practice states	TX
cities	City names, * wildcard allowed	Austin, Aus*
postalCodes	5-digit ZIPs or 2-4 digit prefixes	78701, 787
entityType	any, individual, organization	individual
organizationName, firstName, lastName	Name searches, * wildcard (2+ leading characters)	Walgreens*
npis	Look up specific NPIs	1154494250
maxItems	Cap on unique providers (default 200)	5000
autoSplit	Split searches past the 1,200 cap (default on)	true

A state alone is rejected by the registry; combine it with a specialty, city, ZIP or name.

{ "taxonomy": ["Dentist"], "states": ["TX"], "cities": ["Austin"], "maxItems": 100 }

Output (one row per provider)

{
  "npi": "1013125558",
  "entityType": "organization",
  "name": "8118 DENTAL PROFESSIONALS PLLC",
  "organizationName": "8118 DENTAL PROFESSIONALS PLLC",
  "credential": null,
  "primaryTaxonomy": "Dentist",
  "taxonomyCode": "122300000X",
  "practiceAddress": "8118 SHOAL CREEK",
  "city": "AUSTIN",
  "state": "TX",
  "zip": "78757",
  "practicePhone": "512-452-8262",
  "fax": "512-420-8265",
  "enumerationDate": "2007-05-18",
  "lastUpdated": "2023-05-16",
  "status": "A",
  "url": "https://npiregistry.cms.hhs.gov/provider-view/1013125558",
  "scrapedAt": "2026-11-03T20:08:21+00:00"
}

Individuals also fill firstName, lastName and credential. allTaxonomies lists every specialty on the record.

Pricing

Pay per event: $0.0005 per provider (about $0.50 per 1,000). No start fee. You are charged only for rows delivered; failed or empty searches cost nothing.

Use cases

Healthcare B2B sales lists, credentialing and provider-data checks, directory building, market sizing by specialty and ZIP, verifying an NPI.

FAQ

How fresh is it? It reads the live registry on every run. lastUpdated is the provider's own last update date. Why does a specialty search return some unrelated people? The registry matches the text against every taxonomy on a record, not only the primary one. Filter on primaryTaxonomy if you want primary only. Emails? The registry does not publish them, so there are none. Is it allowed? The NPPES registry is public data published by CMS for free use.

Limits

• A single search cannot be split below one ZIP, one provider type and one two-letter last-name prefix; if that still exceeds 1,200 the run reports it in the run summary (capped).
• Matches on ZIP or city use any address on the record, so a few rows may have a practice location outside the searched ZIP.
• Phone and fax are as entered by the provider; many are blank.