NPI Registry Provider Lookup & Enrichment

Search and export US healthcare providers — doctors, nurses, pharmacies, clinics, hospitals — straight from the official NPI Registry (CMS, public data). Clean, normalized, de-noised output you can drop into a CRM or sales workflow.

Why this Actor

The NPI Registry's public API has a well-known quirk: broad searches on common names (e.g. Smith) silently return alphabetical noise instead of real matches. This Actor fixes that: it over-fetches and verifies every record actually matches your query before returning it — so you get only real Smiths, not a random page of providers.

Input

{ "lastName": "Smith", "state": "CA", "taxonomy": "Family Medicine", "maxItems": 100 }

{ "npiNumbers": ["1932195542", "1184750002"] }

{ "organizationName": "CVS Pharmacy", "providerType": "organization", "state": "TX", "maxItems": 50 }

Field	Description
npiNumbers[]	Exact 10-digit NPI lookups. If set, search filters are ignored.
lastName / firstName	Individual provider name (verified against results).
organizationName	Organization / practice name (verified against results).
taxonomy	Specialty, e.g. "Pharmacy", "Family Medicine", "Internal Medicine".
city / state / postalCode	Location filters. State is strongly recommended to narrow common names.
providerType	any / individual (NPI-1) / organization (NPI-2).
maxItems	Max matching providers to return (controls cost).
enrichContacts	Best-effort: probe a website (from registry endpoints) for a contact email.

Output

{
  "npi": "1932195542",
  "enumerationType": "NPI-1",
  "providerName": "BRENNA ELAINE BAYNARD-SMITH",
  "credential": "MD",
  "organizationName": null,
  "primaryTaxonomy": "Family Medicine",
  "primaryTaxonomyCode": "207Q00000X",
  "taxonomies": ["Family Medicine"],
  "addressLine1": "555 S 7TH AVE",
  "city": "BARSTOW", "state": "CA", "postalCode": "923111303", "country": "US",
  "phone": "760-255-2400", "fax": "760-255-2401",
  "authorizedOfficial": null,
  "endpoints": [],
  "website": null,
  "email": null,
  "npiUrl": "https://npiregistry.cms.hhs.gov/provider-view/1932195542"
}

Organizations (NPI-2) additionally populate organizationName, authorizedOfficial, and authorizedOfficialPhone.

Reliability notes

• Precision-first: every returned record is verified to match your name/org/taxonomy.
• The NPI API caps retrieval at 1,200 records per query. For very common names, add state, city, or taxonomy to surface more matches — the Actor logs a clear warning when it hits this cap.
• Exponential backoff on rate limits / server errors; one failed lookup never sinks the run.
• email/website are best-effort — the NPI Registry rarely lists practice websites, so these are frequently empty. The Actor's core value is the registry data itself (provider, specialty, address, phone, organization, authorized official).

Pricing

Pay per result. Built for high-volume, low-cost enrichment.

Data usage & compliance

All data comes from the public NPI Registry operated by CMS (Centers for Medicare & Medicaid Services), which is published in the public domain for transparency. This Actor performs only lookups against the official public API. Use the data in accordance with applicable laws (e.g. HIPAA does not cover NPI directory data, but downstream use may carry obligations); do not use it for spam or harassment.