NPPES US Healthcare Provider & NPI Registry

Search and verify public US healthcare provider records through the official CMS NPI Registry API. Use this Actor for provider-directory enrichment, NPI validation, organization research, specialty discovery, credential checks, healthcare analytics, and CRM data quality.

This Actor is unofficial and is not affiliated with CMS, HHS, or NPPES. Registry data is directory information, not a provider recommendation or medical advice.

Operations

• probe: bounded availability check; writes no dataset rows.
• search: find individual or organization providers using one or more official CMS filters.
• item: retrieve one provider by exact 10-digit NPI.

Search filters

• Individual: first_name, last_name, and entity_type: I.
• Organization: organization_name and entity_type: O.
• Location: city, two-letter state, or zip_code.
• Specialty: taxonomy_description, for example Family Medicine or Cardiology.
• Identifier: exact npi.

CMS NPI Registry search accepts taxonomy descriptions, not exact taxonomy codes. taxonomy_code is retained as a deprecated input so old integrations receive an actionable invalid_input response instead of misleading results. Inspect taxonomy_primary_code and taxonomies in returned providers.

Examples

Individual provider search:

{"operation":"search","first_name":"Michael","city":"NEW YORK","entity_type":"I","limit":5}

Organization search:

{"operation":"search","organization_name":"Mayo Clinic","entity_type":"O","state":"MN","limit":5}

Specialty discovery:

{"operation":"search","taxonomy_description":"Family Medicine","state":"CA","entity_type":"I","limit":10}

Exact NPI lookup:

{"operation":"item","npi":"1003979261"}

Output semantics

Each dataset row has source: cms_npi_registry and a record_type of individual_provider or organization_provider. Practice (LOCATION) and mailing (MAILING) addresses remain separate. Primary taxonomy is exposed as taxonomy_primary_code; all official taxonomies and licenses remain in taxonomies.

Run status, totals, processed rows, and structured errors are stored under OUTPUT. Missing filters, malformed NPIs, unsupported operations, and deprecated taxonomy-code searches do not silently become a different query.

Limits and cost

The CMS API allows at most 200 results per request. page is 1-based. No proxy or browser is required. The default console action is a lightweight probe; ready-to-run Saved Tasks provide useful examples without contaminating other inputs with schema defaults.