shipapis
StarSubmit an APISubmit API

NPPES

Look up any US healthcare provider by their NPI number

🩺 Health & FoodHEALTHYchecked 5h ago
AUTH NONECORS ✗AGENT ✓HTTPS ✓COMMERCIAL ✓

The CMS NPPES registry API returns public records for US healthcare providers — names, addresses, and taxonomies — keyed by National Provider Identifier. Pass version=2.1 plus at least one search field (like state and city) and you get JSON back. No key, public data.

89HOW IT'S SCORED ⓘ
Docs ↗
Status badge · for your READMEshipapis health badge: 89 · healthy
Uptime history
100%90 days
100%30 days
910P50 · ms
2071P95 · ms
operationalpartialdownno data
Response time · last 48 checks
Fastest 87 ms, slowest 1628 ms, most recent 226 ms.
Live response samplecaptured by our last successful check
GET https://npiregistry.cms.hhs.gov/api/?version=2.1&state=CA&city=San%20Diego&limit=1

{
  "result_count": 1,
  "results": [
    {
      "number": "1033959770",
      "basic": {
        "organization_name": "1 TRUE HEALTH - CALIFORNIA PC",
        "status": "A",
        "enumeration_date": "2024-05-30"
      },
      "addresses": [
        {
          "city": "SAN DIEGO",
          "state": "CA",
          "postal_code": "921231690",
          "address_purpose": "LOCATION"
        }
      ]
    }
  ]
}
Call itcurl · fetch · python
curl "https://npiregistry.cms.hhs.gov/api/?version=2.1&state=CA&city=San%20Diego&limit=1"
const res = await fetch("https://npiregistry.cms.hhs.gov/api/?version=2.1&state=CA&city=San%20Diego&limit=1");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://npiregistry.cms.hhs.gov/api/?version=2.1&state=CA&city=San%20Diego&limit=1")
print(res.json())

BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET

Endpoints · 3HealthyFULL DOCS ↗
Monitored path responding — GET /api/?version=2.1&state=CA&city=San%20Diego&limit=1910 mschecked 5h ago
GET/api/?version=2.1&state=CA&city=San%20Diego&limit=1PROBED

Look up any US healthcare provider by their NPI number

GET/api/?limit=5

Api — documented GET route.

GET/api/?page=1

Api — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

NPPES: common questions

Is NPPES free to use?

Yes — NPPES is a free health & food API. Free tier: Free — no key required. Commercial use is allowed on the free tier.

Does NPPES need an API key?

No — NPPES needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).

Can I call NPPES from the browser?

Not directly — NPPES doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.

Is NPPES up right now?

As of our last scheduled check, NPPES is healthy with 100% uptime over 90 days and a 910 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.