# NPI Registry Provider Lookup

> NPI registry lookup for US providers. Search by taxonomy, state, city or ZIP, or check up to 200 NPI numbers at once. Export to CSV. No API key.

URL: https://cliqtomedia.com/actors/npi-registry-provider-lookup/

Category: Government & open data · Status: coming soon · Apify profile: https://apify.com/cliqtomedia?fpr=cliqto

Search the public NPPES NPI Registry by specialty and place. Or check a list of NPI numbers in one go. You get names, taxonomies and practice addresses in a table.

## How to use it: 3 steps

1. **Follow us on Apify.** The tool is built and waits in the queue for the Apify Store. Apify is the cloud platform where our tools run.
2. **Paste your input and press Start.** No code needed: you fill in a form (the input). It already has a working example. For example: `25` in Maximum providers. Each start is one run.
3. **Download the results.** When the run ends, the results are in a table (the dataset). Open Output, press Export and pick Excel or CSV. JSON and the API are there too.

## What it does

Search the CMS NPPES NPI Registry for US providers by taxonomy and practice location, or look up NPI numbers in a batch. Get provider names, taxonomies, published licence details and practice addresses in an Apify Dataset.

- Search by taxonomy description, state, city, ZIP code, provider type or provider name.
- Look up up to 200 NPI numbers in one input. Duplicate inputs are removed.
- Read pages from NPPES and remove duplicate provider records.
- Save a row for each returned NPI, with the primary taxonomy and all published taxonomies.
- With `onlyNew`, save only NPI numbers that are new to your baseline.



## Price

Prices will be shown after release.

## Questions

### Does this check a medical licence?

No. It shows published licence fields. Ask the licensing authority to verify.

### Can I get doctors' emails or phones?

No. Personal contact fields are left out. Some organization rows may show the practice phone.

### Does onlyNew find changed addresses?

No. It only finds new NPI numbers. Compare full exports to see edits.

### Do I need an NPPES key?

No. The registry is public. You only need an Apify account.

### Can I get doctors' e-mail addresses or personal phone numbers?

No. Individual contact fields are omitted, and no contact enrichment is performed.

### Can I export the whole US registry?

No. Use the CMS downloadable files for national bulk coverage. This Actor supports bounded searches and lookup batches.

## Input settings

- `npis` (array): Up to 200 distinct 10-digit NPI numbers with valid checksums. Use numbers OR search filters. Duplicate numbers are removed. Missing records are listed in RUN_SUMMARY.
- `maxResults` (integer): Maximum saved providers, 1–1000. Search default is 25; lookup default is 1000 when omitted. A reached maximum is reported as partial. Narrow search filters for useful results.
- `onlyNew` (boolean): Compare with your named KVS baseline and save previously unseen NPI numbers only. Does not detect changes to existing providers. Do not run the same stateKey and search concurrently.
- `stateKey` (string): Baseline namespace, 1–64 letters, numbers, underscores or hyphens, starting with a letter or number. Used only with onlyNew; distinct search scopes get separate keys.
- `taxonomyDescription` (string): Taxonomy description, not a taxonomy code. Example: Dentist. Use the source taxonomy wording.
- `state` (string): US state or territory abbreviation. Must be combined with taxonomy, city, postal code or name. Searches practice locations.
- `city` (string): Practice location city, up to 100 characters. Combine with state for a narrow search.
- `postalCode` (string): Practice location ZIP code: exactly 5 or 9 digits. Preserve leading zeros.
- `enumerationType` (string): Empty selects both types; NPI-1 selects individuals and NPI-2 organizations. Cannot be the only search criterion.
- `organizationName` (string): Published organization name, up to 100 characters. Use with NPI-2 for organizations.
- `lastName` (string): Published individual last name, up to 100 characters. A trailing * is allowed after at least two characters. Use with NPI-1.

## Step by step on Apify

1. Open Input.
2. Keep `taxonomyDescription: Dentist`, `state: RI`, `city: Providence` and `maxResults: 25`.
3. Click Start.
4. Open the Providers output and export the Dataset as JSON, CSV or Excel.
5. Read Run summary for the completion status, saved count and missing NPI numbers.

## Use cases

| Task | Input | Useful output |
|---|---|---|
| Build a practice directory | Taxonomy + state + city | NPI, organization, taxonomy, practice address |
| Match an existing NPI list | `npis` | NPI, name, type, source dates and missing-number summary |
| Review published taxonomy details | Name or NPI | Primary taxonomy, all taxonomy codes and published licence fields |

## Tips

- You can check up to 200 NPI numbers per run. Duplicates are removed.
- Use onlyNew to get only NPI numbers you have not seen before.
- For the whole US registry, use the CMS bulk files instead.

## Limits



- Up to 200 NPI inputs and 1000 saved providers. NPPES returns at most 200 records per request. This Actor scans the first 1000 candidates, rather than the whole national registry.
- Search results are a bounded live sample. They are not a snapshot of a fixed total, and source records can change between pages.
- Up to 220 source attempts, 4 MiB per response and 8 MiB across a run. Requests are serial with at least 1.1 seconds between attempts. Retries respect Retry-After within the shared deadline.
- Search source work stops after 120 seconds; lookup source work stops after 240 seconds. Both stop before the platform timeout. A large batch may therefore stop before all NPIs are processed.
- `MAX_RESULTS` means the saved-row cap was reached; narrow filters or raise the cap within the allowed range. `SOURCE_WINDOW_LIMIT` means the scanned source window ended.
- A source error fails the run and writes `error`, or `partial` if rows were already saved. Existing Dataset rows remain available. An input error also fails the run.
- NPI Registry provides active records. A missing result may be unknown, unavailable or deactivated; the API alone cannot tell which. CMS publishes deactivation information separately.
- NPI issuance does not prove a current licence, credential, quality, insurance participation or Medicare enrolment. Data may contain outdated information supplied by providers.

## Sample result

```json
{
  "npi": "1225787708",
  "type": "NPI-2",
  "name": "31 ELMGROVE DENTAL LLC",
  "organization": "31 ELMGROVE DENTAL LLC",
  "credential": null,
  "primaryTaxonomy": {
    "code": "1223G0001X",
    "description": "Dentist, General Practice",
    "primary": true,
    "licenseNumber": null,
    "licenseState": null
  },
  "practiceAddress": {
    "address1": "31 ELMGROVE AVE",
    "address2": null,
    "city": "PROVIDENCE",
    "state": "RI",
    "postalCode": "029064103",
    "countryCode": "US"
  },
  "phone": "401-421-9350",
  "status": "A",
  "enumerationDate": "2022-03-22",
  "lastUpdated": "2022-03-22"
}
```

## Similar tools

- [EU TED Tenders Scraper & Monitor](https://cliqtomedia.com/actors/eu-ted-tenders-scraper/)
- [UK Bank Holidays & Business Day Calculator](https://cliqtomedia.com/actors/uk-bank-holidays-business-days/)
- [UK Postcode Lookup](https://cliqtomedia.com/actors/gb-postcode-lookup/)
- [USAspending Federal Awards & Recipient Monitor](https://cliqtomedia.com/actors/usaspending-federal-awards-monitor/)
- [VIN Decoder & Vehicle Recalls](https://cliqtomedia.com/actors/vin-decoder-vehicle-recalls/)
- [FDA Recalls & Enforcement Monitor](https://cliqtomedia.com/actors/fda-recalls-enforcement-monitor/)