● Public TOOL health.providers SOURCE CMS NPPES

NPPES healthcare providers

Every US healthcare provider in CMS's National Plan & Provider Enumeration System (the NPI Registry) — identity, practice location, taxonomy/specialty, licensure, and OIG exclusion status. Query by NPI, name + state, or taxonomy + state.

Records

9,671,888

Active + deactivated NPIs, individuals and organizations

History

2007–2026

2007-07-08 through 2026-07-13

Cadence

Weekly

Monthly full snapshot + weekly incrementals

Exclusion screen

OIG LEIE

Joined by NPI · JSON · included in subscription

Live-verified 2026-07-17: 9,671,888 providers synced, 2007-07-08 through 2026-07-13.

Coverage & freshness — read this

Cadence. CMS publishes a full monthly snapshot (~1 GB, ~9.67M providers) plus small week-scoped incremental files. We ingest both. A newly enumerated or updated provider appears within one week of CMS publishing it.
Correction bound ≤ 1 month. Weekly files are week-scoped (they carry only that week's changes), and CMS keeps no archive of past weekly files. In the rare case an out-of-order monthly re-load transiently reverts a very recent weekly change, the next monthly snapshot re-corrects it — a worst-case correction window of about one month.
Deactivations lag up to ~1 month. The authoritative deactivation report is published monthly. The report carries the NPI and deactivation date only — it does not publish a deactivation reason, so that field is null from this source.
CMS's own caveat. Issuance of an NPI does not ensure or validate that the provider is licensed or credentialed. Licensure fields are self-reported.

Privacy posture

NPPES is public data that CMS publishes for provider lookup (the same fields power the public NPI Registry). For solo practitioners a business practice-location address can be a home address. To stay at parity with the public registry — and no further — the health.providers tool supports only NPI, name + state, and taxonomy + state queries. There is no bare-address reverse lookup, and no SSN/DOB (never in NPPES) or EIN (masked in the public file) is served.

Query parameters

npistring

Exact 10-digit NPI lookup

name + statestring

Provider or organization name — required with state

taxonomy + statestring

Provider taxonomy code — required with state

is_excludedboolean

Filter to providers on the OIG LEIE exclusion list

limitnumber

Max records per response (default 25, max 50)

A name-only or taxonomy-only query with no state is rejected — this mirrors the public NPI Registry and prevents bulk person lookups.

Example call

Request · health.providers

{
  "tool": "health.providers",
  "params": {
    "taxonomy": "207Q00000X",
    "state": "KS",
    "limit": 25
  }
}

Try in playground

Schema

Field	Type	Description
npi	string	10-digit National Provider Identifier
entity_type	string	individual \| organization
provider_name	string	Org legal name, else "LAST, FIRST" (name-search key)
credential	string	MD, DO, NP, … (self-reported)
primary_taxonomy_code	string	Primary provider taxonomy (specialty), filterable with state
taxonomy_codes	string	All taxonomy slots, ";"-joined
primary_license_number	string	License for the primary taxonomy + its state
practice_state	string	Business practice-location state, filterable
practice_city	string	Practice-location city (result field, not a WHERE key)
is_excluded	boolean	Currently on the OIG LEIE exclusion list
exclusion_type	string	OIG exclusion authority (e.g. 1128a1)
enumeration_date	ISO date	Date the NPI was enumerated
last_update_date	ISO date	NPPES last-update date
exclusion_date	ISO date	Date added to the OIG LEIE exclusion list, when excluded (deactivation reason is not published by CMS)

Sample record

Sample · health.providers

{
  "npi": "1710670039",
  "entity_type": "individual",
  "provider_name": "HUNTER, HEATHER",
  "credential": "",
  "primary_taxonomy_code": "101YP2500X",
  "primary_license_number": "04558",
  "primary_license_state": "KS",
  "practice_state": "KS",
  "practice_city": "WICHITA",
  "is_excluded": false,
  "enumeration_date": "2023-06-01",
  "last_update_date": "2026-07-06"
}

Use it for

Provider directory + taxonomy/credential lookup for an agent
OIG-exclusion screening joined to claims or referral data
Provider-network coverage checks by state and specialty

● Public Daily

ClinicalTrials.gov registrations

health.trials

Trial registrations, status, and sponsor detail — providers named as investigators can be cross-referenced by name.

Included in subscription View dataset

● Public Weekly

NIH research grants

health.nih_grants

NIH RePORTER awards by organization, PI, and institute — joinable to providers by organization and state.