How complete is the registry?

All 9.37 million active NPIs from the official CMS NPPES file: about 7.4 million individual practitioners and 2 million organizations. Deactivated NPIs are removed, so a hit means the provider is current.

What does a provider record include?

Name, credential such as MD, DO or NP, gender, every taxonomy code with the primary one flagged and resolved to a readable specialty name, licence number and state for the primary specialty, practice and mailing addresses, and phone numbers, all cleaned from the raw NPPES formatting.

How are specialties resolved?

Every taxonomy code is joined to the NUCC Health Care Provider Taxonomy, about 880 codes, so a code like 207X00000X comes back as Orthopaedic Surgery. The taxonomy endpoints let you search and browse the codes themselves.

How often is the data refreshed?

The full NPPES file is loaded monthly and the weekly incremental files are applied by a daily job, so new and changed providers appear within days of CMS publishing them.

Can I search without an NPI?

Yes. The search endpoint filters by name, specialty, city, state and entity type, with paging, and there is a random endpoint for sampling.

HealthMAINTAINED1 token / call

Healthcare Providers API

Look up any of 9.37 million US NPIs with specialties resolved to plain names

The complete US healthcare provider registry, self-hosted and queryable: 9.37 million active NPIs from the official CMS NPPES dissemination — 7.4M individual practitioners and 2M organizations — with every specialty code resolved to a human-readable name via the NUCC taxonomy. Look up any 10-digit NPI and get the provider's name, credential (MD, DO, NP...), gender, all taxonomy codes with the primary flagged and named ("Orthopaedic Surgery Physician"), practice address with formatted phone, enumeration date and last update. Search by name prefix, last name, state, city, ZIP, taxonomy code, free-text specialty ("cardiovascular" finds the right NUCC codes) or entity type — engineered so every filter combination stays index-backed across 9.4M rows. Deactivated NPIs are excluded and removed as CMS deactivates them: the database refreshes daily from the official NPPES weekly incremental files. Includes the full NUCC specialty codebook as its own endpoint. Built for healthtech onboarding, provider directories, claims validation, pharma territory planning and recruiting. Public-domain source data; self-hosted — no third-party calls at request time.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "ok": true,
  "provider": {
    "npi": 1679576722,
    "entity_type": "individual",
    "name": "David Wiebe",
    "first_name": "David",
    "last_name": "Wiebe",
    "credential": "M.D.",
    "gender": "M",
    "organization_other_name": null,
    "sole_proprietor": false,
    "specialty": "Orthopaedic Surgery Physician",
    "taxonomies": [
      {
        "code": "207X00000X",
        "primary": true,
        "specialty": "Orthopaedic Surgery Physician",
        "grouping": "Allopathic & Osteopathic Physicians"
      }
    ],
    "practice_location": {
      "street": "3500 Central Ave",
      "city": "Kearney",
      "state": "NE",
      "zip": "68847",
      "country": "US",
      "phone": "(308) 865-2512"
    },
    "enumeration_date": "2005-05-23",
    "last_updated": "2026-07-13"
  }
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Healthcare Providers API

Verify a provider's NPI, name and credential at the point of referral, claim or e-prescription.
Pre-fill provider profiles in a telehealth or scheduling product from a 10-digit NPI instead of asking the clinician to type everything.
Build a searchable directory of practitioners by specialty, city or state for patients or care coordinators.
Validate rendering and billing providers in a claims pipeline, including taxonomy codes and the licence attached to the primary specialty.

Healthcare Providers API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETData Sources
GETGet Provider By NPI
GETGet Taxonomy Code
GETRandom Providers
GETSearch Providers
GETSearch Taxonomies

GETData Sources

https://api-healthcare-providers.dataandapis.com/v1/sources

This endpoint takes no parameters.

Example request

curl "https://api-healthcare-providers.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 2,
  "sources": [
    {
      "slug": "nppes",
      "name": "CMS NPPES Data Dissemination (full monthly file)",
      "publisher": "US Centers for Medicare & Medicaid Services",
      "licence": "US Government work - public domain",
      "source_url": "https://download.cms.gov/nppes/NPI_Files.html",
      "file_url": "https://download.cms.gov/nppes/NPPES_Data_Dissemination_August_2026_V2.zip",
      "cadence": "monthly full + weekly incrementals",
      "record_count": 9374927,
      "retrieved_at": "2026-09-02"
    },
    {
      "slug": "nucc-taxonomy",
      "name": "NUCC Health Care Provider Taxonomy",
      "publisher": "National Uniform Claim Committee",
      "licence": "Freely available; (c) American Medical Association",
      "source_url": "https://www.nucc.org/",
      "file_url": "https://www.nucc.org/images/stories/CSV/nucc_taxonomy_251.csv",
      "cadence": "twice yearly",
      "record_count": 883,
      "retrieved_at": "2026-09-02"
    }
  ]
}

GETGet Provider By NPI

https://api-healthcare-providers.dataandapis.com/v1/providers/{npi}

Path parameters

Parameter	Example
npi	1679576722	Required

Example request

curl "https://api-healthcare-providers.dataandapis.com/v1/providers/1679576722" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "provider": {
    "npi": 1679576722,
    "entity_type": "individual",
    "name": "David Wiebe",
    "first_name": "David",
    "last_name": "Wiebe",
    "credential": "M.D.",
    "gender": "M",
    "organization_other_name": null,
    "sole_proprietor": false,
    "specialty": "Orthopaedic Surgery Physician",
    "taxonomies": [
      {
        "code": "207X00000X",
        "primary": true,
        "specialty": "Orthopaedic Surgery Physician",
        "grouping": "Allopathic & Osteopathic Physicians"
      }
    ],
    "practice_location": {
      "street": "3500 Central Ave",
      "city": "Kearney",
      "state": "NE",
      "zip": "68847",
      "country": "US",
      "phone": "(308) 865-2512"
…

Show full response

{
  "ok": true,
  "provider": {
    "npi": 1679576722,
    "entity_type": "individual",
    "name": "David Wiebe",
    "first_name": "David",
    "last_name": "Wiebe",
    "credential": "M.D.",
    "gender": "M",
    "organization_other_name": null,
    "sole_proprietor": false,
    "specialty": "Orthopaedic Surgery Physician",
    "taxonomies": [
      {
        "code": "207X00000X",
        "primary": true,
        "specialty": "Orthopaedic Surgery Physician",
        "grouping": "Allopathic & Osteopathic Physicians"
      }
    ],
    "practice_location": {
      "street": "3500 Central Ave",
      "city": "Kearney",
      "state": "NE",
      "zip": "68847",
      "country": "US",
      "phone": "(308) 865-2512"
    },
    "enumeration_date": "2005-05-23",
    "last_updated": "2026-07-13"
  }
}

GETGet Taxonomy Code

https://api-healthcare-providers.dataandapis.com/v1/taxonomies/{code}

Path parameters

Parameter	Example
code	207X00000X	Required

Example request

curl "https://api-healthcare-providers.dataandapis.com/v1/taxonomies/207X00000X" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "code": "207X00000X",
  "grouping": "Allopathic & Osteopathic Physicians",
  "classification": "Orthopaedic Surgery",
  "specialization": null,
  "display_name": "Orthopaedic Surgery Physician",
  "section": "Individual",
  "providers_with_primary": 36899
}

GETRandom Providers

https://api-healthcare-providers.dataandapis.com/v1/providers/random

Query parameters

Parameter	Example
amount	3	Optional

Example request

curl "https://api-healthcare-providers.dataandapis.com/v1/providers/random?amount=3" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 1,
  "results": [
    {
      "npi": 1417000100,
      "entity_type": "individual",
      "name": "Alvin Bryan",
      "first_name": "Alvin",
      "last_name": "Bryan",
      "credential": "MD",
      "gender": "M",
      "organization_other_name": null,
      "sole_proprietor": false,
      "specialty": "Anatomic Pathology & Clinical Pathology Physician",
      "taxonomies": [
        {
          "code": "207ZP0102X",
          "primary": true,
          "specialty": "Anatomic Pathology & Clinical Pathology Physician",
          "grouping": "Allopathic & Osteopathic Physicians"
        }
      ],
      "practice_location": {
        "street": "1520 N Leg Rd",
        "city": "Augusta",
        "state": "GA",
        "zip": "30909",
…

Show full response

{
  "ok": true,
  "count": 1,
  "results": [
    {
      "npi": 1417000100,
      "entity_type": "individual",
      "name": "Alvin Bryan",
      "first_name": "Alvin",
      "last_name": "Bryan",
      "credential": "MD",
      "gender": "M",
      "organization_other_name": null,
      "sole_proprietor": false,
      "specialty": "Anatomic Pathology & Clinical Pathology Physician",
      "taxonomies": [
        {
          "code": "207ZP0102X",
          "primary": true,
          "specialty": "Anatomic Pathology & Clinical Pathology Physician",
          "grouping": "Allopathic & Osteopathic Physicians"
        }
      ],
      "practice_location": {
        "street": "1520 N Leg Rd",
        "city": "Augusta",
        "state": "GA",
        "zip": "30909",
        "country": "US",
        "phone": "(706) 869-3121"
      },
      "enumeration_date": "2007-01-18",
      "last_updated": "2015-08-05"
    }
  ]
}

GETSearch Providers

https://api-healthcare-providers.dataandapis.com/v1/providers

Query parameters

Parameter	Example
city	Rochester	Optional
last_name		Optional
limit	20	Optional
page	1	Optional
q	Mayo Clinic	Optional
specialty		Optional
state	MN	Optional
taxonomy		Optional
type		Optional
zip		Optional

Example request

curl "https://api-healthcare-providers.dataandapis.com/v1/providers?city=Rochester&limit=20&page=1&q=Mayo%20Clinic&state=MN" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "total": 24,
  "page": 1,
  "limit": 20,
  "count": 3,
  "results": [
    {
      "npi": 1083249577,
      "entity_type": "organization",
      "name": "Mayo Clinic",
      "credential": null,
      "specialty": "Clinical Medical Laboratory",
      "city": "Rochester",
      "state": "MN"
    },
    {
      "npi": 1114343860,
      "entity_type": "organization",
      "name": "Mayo Clinic",
      "credential": null,
      "specialty": "Infectious Disease Physician",
      "city": "Rochester",
      "state": "MN"
    },
    {
      "npi": 1164758868,
      "entity_type": "organization",
…

Show full response

{
  "ok": true,
  "total": 24,
  "page": 1,
  "limit": 20,
  "count": 3,
  "results": [
    {
      "npi": 1083249577,
      "entity_type": "organization",
      "name": "Mayo Clinic",
      "credential": null,
      "specialty": "Clinical Medical Laboratory",
      "city": "Rochester",
      "state": "MN"
    },
    {
      "npi": 1114343860,
      "entity_type": "organization",
      "name": "Mayo Clinic",
      "credential": null,
      "specialty": "Infectious Disease Physician",
      "city": "Rochester",
      "state": "MN"
    },
    {
      "npi": 1164758868,
      "entity_type": "organization",
      "name": "Mayo Clinic",
      "credential": null,
      "specialty": "Community Based Hospice Care Agency",
      "city": "Rochester",
      "state": "MN"
    }
  ]
}

GETSearch Taxonomies

https://api-healthcare-providers.dataandapis.com/v1/taxonomies

Query parameters

Parameter	Example
limit	50	Optional
q	orthopaedic	Optional
section	Individual	Optional

Example request

curl "https://api-healthcare-providers.dataandapis.com/v1/taxonomies?limit=50&q=orthopaedic&section=Individual" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 3,
  "taxonomies": [
    {
      "code": "207X00000X",
      "grouping": "Allopathic & Osteopathic Physicians",
      "classification": "Orthopaedic Surgery",
      "specialization": null,
      "display_name": "Orthopaedic Surgery Physician",
      "section": "Individual"
    },
    {
      "code": "207XS0114X",
      "grouping": "Allopathic & Osteopathic Physicians",
      "classification": "Orthopaedic Surgery",
      "specialization": "Adult Reconstructive Orthopaedic Surgery",
      "display_name": "Adult Reconstructive Orthopaedic Surgery Physician",
      "section": "Individual"
    },
    {
      "code": "207XX0004X",
      "grouping": "Allopathic & Osteopathic Physicians",
      "classification": "Orthopaedic Surgery",
      "specialization": "Foot and Ankle Surgery",
      "display_name": "Orthopaedic Foot and Ankle Surgery Physician",
      "section": "Individual"
    }
…

Show full response

{
  "ok": true,
  "count": 3,
  "taxonomies": [
    {
      "code": "207X00000X",
      "grouping": "Allopathic & Osteopathic Physicians",
      "classification": "Orthopaedic Surgery",
      "specialization": null,
      "display_name": "Orthopaedic Surgery Physician",
      "section": "Individual"
    },
    {
      "code": "207XS0114X",
      "grouping": "Allopathic & Osteopathic Physicians",
      "classification": "Orthopaedic Surgery",
      "specialization": "Adult Reconstructive Orthopaedic Surgery",
      "display_name": "Adult Reconstructive Orthopaedic Surgery Physician",
      "section": "Individual"
    },
    {
      "code": "207XX0004X",
      "grouping": "Allopathic & Osteopathic Physicians",
      "classification": "Orthopaedic Surgery",
      "specialization": "Foot and Ankle Surgery",
      "display_name": "Orthopaedic Foot and Ankle Surgery Physician",
      "section": "Individual"
    }
  ]
}

Where the data comes from

Source: CMS NPPES Data Dissemination files (public domain) joined with the NUCC Health Care Provider Taxonomy for specialty names.
Freshness: Monthly full reload plus weekly incremental updates applied daily. Deactivated NPIs are deleted.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

6endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-healthcare-providers.dataandapis.com/v1/sources',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Healthcare Providers API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Target:

Client:

import axios from 'axios';

const url = 'https://api-healthcare-providers.dataandapis.com/v1/sources';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});