NPPES NPI Registry Lookup & Scraper API

Search the official public National Plan and Provider Enumeration System (NPPES) NPI Registry by provider name, organization, NPI number, taxonomy, city, state, or ZIP. Export NPI records for provider-directory research, healthcare lead generation, data QA, and credentialing prechecks.

The actor queries the current CMS NPI Registry API at run time. No external API key or proxy is required.

What you get

Field	Meaning
npi	10-digit National Provider Identifier
enumerationType	NPI-1 individual or NPI-2 organization
status	NPI record status (A active or D deactivated)
firstName, lastName, credential	Individual-provider fields reported in NPPES
organizationName, authorizedOfficialName	Organization fields reported in NPPES
primarySpecialty, primaryTaxonomyCode, specialties	Reported taxonomy entries and license fields
practiceAddress, practiceCity, practiceState, practicePostalCode, practicePhone	Reported practice-location contact data
mailingAddress, mailingCity, mailingState, mailingPostalCode	Reported mailing address
enumerationDate, lastUpdated	NPI enumeration and record-update dates
otherNames	Alternate names included in the registry record
resultStatus, matchType, message	Explicit found/no-match outcome and match classification
sourceSystem, sourceUrl, sourceRetrievedAt	Official-source provenance
evidenceScope, coverageNotice, interpretationNotice	Mandatory scope and decision-use limits

All records use the same stable top-level keys. Individual-only and organization-only fields stay present with empty values, and arrays serialize as [] rather than null.

Search examples

Individual provider lookup

{
  "searchType": "individual",
  "firstName": "John",
  "lastName": "Smith",
  "state": "CA",
  "maxResults": 25
}

Organization lookup

{
  "searchType": "organization",
  "organizationName": "Mayo Clinic",
  "state": "MN",
  "maxResults": 25
}

Exact NPI lookup

{
  "searchType": "npi",
  "npi": "1881018208",
  "maxResults": 1
}

Specialty and location search

{
  "searchType": "individual",
  "taxonomyDescription": "Cardiology",
  "state": "NY",
  "maxResults": 100
}

Input

Field	Description
searchType	individual, organization, or npi
firstName, lastName	Individual-provider name filters
organizationName	Organization or facility name filter
npi	Exact 10-digit NPI number
taxonomyDescription	Taxonomy-description filter, such as Cardiology or Dentist
city, state, postalCode	Location filters
maxResults	Total output cap, from 1 to 10,000; default 1

Empty input uses exact Mayo Clinic NPI 1881018208 and returns one record for a deterministic first run costing at most $0.0021. Search fields have no real provider-name or location defaults, so changing search modes cannot silently retain John Smith or CA filters. NPPES returns at most 200 records per API page; the actor paginates until it reaches maxResults, the buyer's Apify charge limit, or the source has no more matches.

Use cases

• Build healthcare-provider or organization lead lists by taxonomy and location
• Look up an NPI and reported practice contact data
• Seed or QA provider directories
• Cross-check provider names, addresses, taxonomies, and NPI record status
• Prepare a source-backed precheck before credentialing or enrollment review
• Research provider distribution by geography or taxonomy

Important interpretation limits

An NPI is an administrative identifier. NPI assignment or an active NPI record does not prove:

• an active professional license or good standing
• Medicare or Medicaid enrollment, billing eligibility, or ordering/referring authority
• credentialing, board certification, sanctions clearance, or current employment
• identity ownership, current practice, or the accuracy of every submitted field

Credentials, taxonomies, license values, names, addresses, and phone numbers are registry fields reported through NPPES and can be incomplete, stale, or changed later. status: "A" means the NPI record is active; it is not a license, enrollment, or compliance status. Similar names are not identity matches.

For public Medicare enrollment evidence, use the separate CMS PECOS Medicare Provider Enrollment Screening actor. For exclusion screening, use HHS OIG LEIE Exclusion Screening. Those sources also have their own scope and interpretation limits.

Source

Data comes from the official CMS NPI Registry API. The actor queries that public source directly and preserves the returned registry fields in a flattened export-friendly record.

Pricing

Pay per event:

• Actor start: $0.0001 minimum
• Dataset result: $0.002 per output record

The one-record default costs at most $0.0021. Examples: 25 results cost about $0.0501 and 1,000 results cost about $2.0001, plus any applicable Apify platform charges or credits shown in your account. If a buyer sets an Apify maximum total charge, the actor reduces maxResults before querying and does not knowingly exceed the affordable paid-result count.

Output and integrations

Results are written to the default Apify dataset for JSON, CSV, Excel, XML, or RSS export. Runs can be called from the Apify API, schedules, webhooks, Make, Zapier, Google Sheets, or the official Apify n8n node.