GET /npi/{npi}

NPI Lookup API

Look up any US healthcare provider by NPI. The registry, plus the flags.

Try it

npi

The number as folded, digits only. Invalid input still echoes the fold

valid

10 digits and the Luhn check digit with the 80840 prefix holds

registered

The NPI exists in the NPPES registry. null when the number is invalid

active

Not deactivated. null when not registered

excluded

On the OIG LEIE exclusion list, matched by NPI only. false is not clearance: many LEIE rows carry no NPI. null when not registered

type

individual or organization

name

Provider name. Organizations ship the legal business name

credential

Credential as the provider registered it (MD, DDS). null for organizations

specialty

Primary taxonomy display name from the NUCC code set

taxonomy

The primary NUCC taxonomy code

address

Practice location street line

city

Practice location city

state

Practice location state code

postal

Practice location postal code, ZIP+4 when NPPES has it

phone

Practice location phone, E.164

1

Pass the number

Ten digits. Spaces and punctuation fold out. Junk answers valid false, never a 404.

2

Get the provider

Name, credential, specialty with its taxonomy code, practice address, and phone. Individuals and organizations.

3

Check the flags

active means not deactivated. excluded checks the OIG exclusion list by NPI.

8.4 million providers.

The full registry. Pooled requests on every plan.

8.4M
providers in the registry
19
fields per lookup

Pass an NPI. Ten digits, spaces and punctuation fold out. You get the checksum verdict and the registry record: provider name, individual or organization, credential, primary specialty with its NUCC taxonomy code, practice address, and phone. active says the number is not deactivated. excluded checks the OIG exclusion list by NPI.

Junk and a failed checksum answer valid: false as a 200. A checksum-valid number the registry does not know answers registered: false with record fields null. We serve the published NPPES dissemination file only. Provider directory data, not PHI.

RESPONSE

$ curl "https://api.parseapi.com/npi/1881018208" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~34ms US · ~124ms worldwide
{
  "npi": "1881018208",
  "valid": true,
  "registered": true,
  "active": true,
  "excluded": false,
  "type": "organization",
  "name": "Mayo Clinic",
  "first": null,
  "last": null,
  "credential": null,
  "specialty": "General Acute Care Hospital",
  "taxonomy": "282N00000X",
  "address": "200 1st St SW",
  "city": "Rochester",
  "state": "MN",
  "state_name": "Minnesota",
  "postal": "55905-0001",
  "country": "US",
  "phone": "+15072842511"
}

Response fields

npi
The number as folded, digits only. Invalid input still echoes the fold
valid
10 digits and the Luhn check digit with the 80840 prefix holds
registered
The NPI exists in the NPPES registry. null when the number is invalid
active
Not deactivated. null when not registered
excluded
On the OIG LEIE exclusion list, matched by NPI only. false is not clearance: many LEIE rows carry no NPI. null when not registered
type
individual or organization
name
Provider name. Organizations ship the legal business name
first
First name. null for organizations
last
Last name. null for organizations
credential
Credential as the provider registered it (MD, DDS). null for organizations
specialty
Primary taxonomy display name from the NUCC code set
taxonomy
The primary NUCC taxonomy code
address
Practice location street line
city
Practice location city
state
Practice location state code
state_name
State display name
postal
Practice location postal code, ZIP+4 when NPPES has it
country
Practice location country, ISO 3166-1 alpha-2
phone
Practice location phone, E.164

QUESTIONS

What if it is not an NPI?
valid: false as a 200. npi still echoes the folded digits. Same as a typo in a form field.
What does registered: false mean?
The checksum holds but NPPES has no record of the number. Record fields ship null.
Where does the data come from?
We serve the published NPPES dissemination file only. Provider directory data, not PHI, so there is no HIPAA exposure and no BAA needed.
Is an NPI proof of licensure?
No. An NPI is not proof of licensure. CMS says so and so do we. Licenses belong to the state boards.
What is excluded?
Whether the NPI is on the OIG LEIE exclusion list, matched by NPI only. excluded: false is not clearance. LEIE rows without an NPI cannot be matched by number.
Why not the official API?
CMS publishes the registry and a lookup API that allows a couple of requests a second. We serve the same published file worldwide at your plan's rate limit.
Can I search by name?
No. Pass the number. A claim, a referral, and a prescription already carry it.
What does it cost?
Nothing extra. A lookup is one pooled request on any plan.

SPEED

How long a lookup takes.

US

34ms

EU

60ms

APAC

148ms

LatAm

21ms

ME

124ms

See live status →

Coverage

8.4 million US providers. The full published registry.

Get startedDocs