Skip to main content
All providers

NPI Registry

HealthUS

npiregistry.cms.hhs.gov

Every US healthcare provider's National Provider Identifier, taxonomy and practice address.

Capabilities (14)

GET /v1/data/npi/address1 credit

Lists every enumerated provider, individual or organisational, whose NPPES address line matches a given street and city, with their NPIs, names, taxonomies and the rest of the address.

address_1citystate?postal_code?country_code?address_purpose?enumeration_type?taxonomy_description?limit?skip?
GET /v1/data/npi/area1 credit

Returns the roster of enumerated providers in one postal code (NPI, name, taxonomies, addresses and status) with no name or specialty needed to start.

postal_codeenumeration_type?city?state?country_code?address_purpose?taxonomy_description?limit?skip?
GET /v1/data/npi/authorized-official1 credit

Finds organisational NPIs whose authorised official (the human legally responsible for the enumeration) carries a given name, returning each organisation's NPI, legal name, taxonomies and addresses.

last_namefirst_name?city?state?postal_code?country_code?taxonomy_description?limit?skip?
GET /v1/data/npi/medicare-enrollment1 credit

Returns every Medicare fee-for-service enrollment PECOS holds for one NPI (2026-10-01 release): enrollment id, PECOS associate control id, provider type code and description, the state it is enrolled in, and the individual or organisation name.

npisize?offset?
GET /v1/data/npi/number1 credit

Returns the single NPPES record for one 10-digit NPI: enumeration type and date, status, NUCC taxonomies, practice and mailing addresses, other identifiers and (for organisations) the authorised official.

number
GET /v1/data/npi/opt-out1 credit

Returns the Medicare opt-out affidavit on file for one NPI (2026-08-01 release): specialty, effective and end dates of the opt-out period, the address filed with it, and whether the clinician may still order and refer.

npisize?offset?
GET /v1/data/npi/order-referring1 credit

Returns the CMS Order and Referring row (2026-10-20 release) for one NPI: the clinician's name plus Y/N flags for whether they may order or refer Part B services, DME, home health, power mobility devices and hospice.

npisize?offset?
GET /v1/data/npi/organizations1 credit

Searches the NPPES registry for organisational (type 2) providers (hospitals, clinics, group practices, pharmacies, labs), returning NPI, legal and other business names, taxonomies, addresses and the authorised official on file.

organization_name?taxonomy_description?city?state?postal_code?country_code?address_purpose?limit?skip?
GET /v1/data/npi/reassignment1 credit

Returns the clinic and group practice reassignment rows for one individual NPI (2026-10-01 release): each group's legal business name, PAC id, enrollment id, state and due date, alongside the individual's own enrollment, specialty and employer-association count.

npisize?offset?
GET /v1/data/npi/revalidation1 credit

Returns the Medicare revalidation rows for one NPI (2026-10-01 release): enrollment id, enrollment type and specialty, state, the published revalidation due date and any adjusted date, plus counts of reassignments to and from the provider.

npisize?offset?
GET /v1/data/npi/search1 credit

Searches the NPPES registry for individual (type 1) clinicians by name, specialty and location, returning each provider's NPI, credentials, taxonomies, addresses and other identifiers.

first_name?last_name?use_first_name_alias?taxonomy_description?city?state?postal_code?country_code?address_purpose?limit?skip?
GET /v1/data/npi/taxonomy1 credit

Lists providers whose NUCC taxonomy matches a specialty description, optionally narrowed to a city, state or ZIP, with each one's NPI, name, full taxonomy list and addresses.

taxonomy_descriptionenumeration_type?city?state?postal_code?country_code?address_purpose?limit?skip?
GET /v1/data/npi/taxonomy-crosswalk1 credit

The complete 566-row CMS crosswalk (2026-08-01 release) between NUCC provider taxonomy codes, their full type/classification/specialisation text, and the Medicare specialty codes and supplier-type descriptions they map to.

keyword?column?offset?
GET /v1/data/npi/utilization1 credit

Returns the calendar-year 2024 Medicare Physician and Other Practitioners summary for one NPI: distinct HCPCS codes, beneficiary and service counts, submitted charges and allowed, paid and standardised amounts split into drug and medical, plus beneficiary age, sex, race, dual-eligible and average risk-score breakdowns.

npisize?offset?

Response example

The shape of data from npi/address (Providers at a street address). A sample, not live data.

Example truncated, full shape in JSON from the API.

JSON
{
  "result_count": 10,
  "results": [
    {
      "addresses": [
        {
          "address_1": "1008 12TH STREET SE",
          "address_purpose": "MAILING",
          "address_type": "DOM",
          "city": "ROCHESTER",
          "country_code": "US",
          "country_name": "United States",
          "fax_number": "507-287-8846",
          "postal_code": "559045030",
          "state": "MN",
          "telephone_number": "507-282-6448"
        },
        {
          "address_1": "1008 12TH STREET SE",
          "address_purpose": "LOCATION",
          "address_type": "DOM",
          "city": "ROCHESTER",
          "country_code": "US",
          "country_name": "United States",
          "fax_number": "507-287-8846",
          "postal_code": "559045030",
          "state": "MN",
          "telephone_number": "507-282-6448"
        }
      ],
      "basic": {
        "authorized_official_credential": "DDS",
        "authorized_official_first_name": "JOSEPH",
        "authorized_official_last_name": "BECKER",
        "authorized_official_middle_name": "GERARD",
        "authorized_official_name_prefix": "Dr.",
        "authorized_official_name_suffix": "--",
        "authorized_official_telephone_number": "5072826448",
        "authorized_official_title_or_position": "Owner Partner Dentist",
        "enumeration_date": "2006-12-21",
        "last_updated": "2020-08-22",
        "organization_name": "12TH STREET DENTAL OFFICE PA",
        "organizational_subpart": "NO",
        "status": "A"
      },
      "created_epoch": "1166730619000",
      "endpoints": [],
      "enumeration_type": "NPI-2",
      "identifiers": [],
      "last_updated_epoch": "1598100723000",
      "number": "1043374176",
      "other_names": [],
      "practiceLocations": [],
      "taxonomies": [
        {
          "code": "122300000X",
          "desc": "Dentist",
          "license": "MN9567",
          "primary": true,
          "state": "MN",
          "taxonomy_group": "193400000X - Single Specialty Group"
        }
      ]
    },
    {
      "addresses": [
        {
          "address_1": "9 DAISY ST",
          "address_purpose": "MAILING",
          "address_type": "DOM",
          "city": "ROCHESTER",
          "country_code": "US",
          "country_name": "United States",
          "postal_code": "146153610",
          "state": "NY",
          "telephone_number": "585-748-1194"
        },
        {
          "address_1": "9 DAISY ST",
          "address_purpose": "LOCATION",
          "address_type": "DOM",
          "city": "ROCHESTER",
          "country_code": "US",
          "country_name": "United States",
          "postal_code": "146153610",
          "state": "NY",
          "telephone_number": "585-208-9280"
        }
      ],
      "basic": {
        "authorized_official_first_name": "THADDEUS",
        "authorized_official_last_name": "GRIFFIN",
        "authorized_official_middle_name": "L",
        "authorized_official_name_suffix": "Sr.",
        "authorized_official_telephone_number": "5857481194",
        "authorized_official_title_or_position": "CEO",
        "enumeration_date": "2018-01-02",
        "last_updated": "2018-01-02",
        "organization_name": "1ST PRIORITY TRANSPORTATION LLC",
        "organizational_subpart": "NO",
        "status": "A"
      },
      "created_epoch": "1514908752000",
      "endpoints": [],
      "enumeration_type": "NPI-2",
      "identifiers": [],
      "last_updated_epoch": "1514908752000",
      "number": "1972010858",
      "other_names": [],
      "practiceLocations": [],
      "taxonomies": [
        {
          "code": "172A00000X",
          "desc": "Driver",
          "license": "670358397",
          "primary": false,
          "state": "NY",
          "taxonomy_group": "193400000X - Multiple Single Specialty Group"
        },
        {
          "code": "172A00000X",
          "desc": "Driver",
          "license": "198104499",
          "primary": false,
          "state

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • Providers at a street address

    Use NPI Registry (npi) from fastCRW Pergamon, capability "Providers at a street address" (address). You have a building or practice address and want to know who bills from it. Example options: address_1=200 First St SW, city=Rochester, state=MN. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "npi" and capability "address". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Providers in a ZIP code

    Use NPI Registry (npi) from fastCRW Pergamon, capability "Providers in a ZIP code" (area). You want to see who practises in a geographic area and have neither a name nor a specialty to anchor the search. Example options: postal_code=55905, enumeration_type=NPI-1, city=Rochester. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "npi" and capability "area". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Organizations by authorized official

    Use NPI Registry (npi) from fastCRW Pergamon, capability "Organizations by authorized official" (authorized-official). You have the name of an executive or owner and want every healthcare entity registered under them. Example options: last_name=Gonzalez, first_name=Maria, city=Houston. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "npi" and capability "authorized-official". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Medicare enrollment records

    Use NPI Registry (npi) from fastCRW Pergamon, capability "Medicare enrollment records" (medicare-enrollment). You need to confirm an NPI is actually enrolled in Medicare, in which states and under which provider types, rather than merely enumerated in NPPES. Example options: npi=1003000126, size=100, offset=0. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "npi" and capability "medicare-enrollment". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

Licence

A work of the United States Government, not subject to domestic copyright under 17 U.S.C. 105, published by the agency as open data.

https://npiregistry.cms.hhs.gov/help-api/terms

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: CMS NPI Registry

Cache: up to 3600s