← Docs

NPI Lookup API

Any NPI in the registry. Provider, specialty, address, exclusions.

Look up a National Provider Identifier in the CMS NPPES registry. You get the checksum verdict and the record: provider name, individual or organization, credential, primary specialty with its NUCC taxonomy code, practice address, and phone. Junk or a failed checksum answers valid: false as a 200, never a 404. A checksum-valid number the registry does not know answers registered: false with record fields null.

active means the number is not deactivated. excluded checks the OIG LEIE exclusion list by NPI, and false is not clearance: LEIE rows without an NPI cannot be matched by number. An NPI is not proof of licensure. We serve the published NPPES dissemination file only. Provider directory data, not PHI.

Lookup

GET
api.parseapi.com/npi/{npi}
Provider, specialty, practice address, and flags from the registry
curl "https://api.parseapi.com/npi/1881018208" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "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"
}
curl "https://api.parseapi.com/npi/1891058467" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "npi": "1891058467",
  "valid": true,
  "registered": true,
  "active": true,
  "excluded": false,
  "type": "individual",
  "name": "Rasha Abdelsalam",
  "first": "Rasha",
  "last": "Abdelsalam",
  "credential": "MD",
  "specialty": "Family Medicine Physician",
  "taxonomy": "207Q00000X",
  "address": "2283 S Monaco Pkwy Ste 105",
  "city": "Denver",
  "state": "CO",
  "state_name": "Colorado",
  "postal": "80222",
  "country": "US",
  "phone": "+17205312370"
}
curl "https://api.parseapi.com/npi/1891-058-467" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "npi": "1891058467",
  "valid": true,
  "registered": true,
  "active": true,
  "excluded": false,
  "type": "individual",
  "name": "Rasha Abdelsalam",
  "first": "Rasha",
  "last": "Abdelsalam",
  "credential": "MD",
  "specialty": "Family Medicine Physician",
  "taxonomy": "207Q00000X",
  "address": "2283 S Monaco Pkwy Ste 105",
  "city": "Denver",
  "state": "CO",
  "state_name": "Colorado",
  "postal": "80222",
  "country": "US",
  "phone": "+17205312370"
}
curl "https://api.parseapi.com/npi/1234567890" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "npi": "1234567890",
  "valid": false,
  "registered": null,
  "active": null,
  "excluded": null,
  "type": null,
  "name": null,
  "first": null,
  "last": null,
  "credential": null,
  "specialty": null,
  "taxonomy": null,
  "address": null,
  "city": null,
  "state": null,
  "state_name": null,
  "postal": null,
  "country": null,
  "phone": null
}

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? Email