NPI

GET/v0/us/npi

Validates a National Provider Identifier (NPI) — the 10-digit number issued by the US Centers for Medicare & Medicaid Services (CMS) to uniquely identify healthcare providers. The check digit is verified using the Luhn algorithm with the health industry prefix 80840 prepended per the CMS specification. Spaces and hyphens are stripped automatically. Optionally looks up provider details from the NPPES registry.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	The 10-digit NPI number (e.g. `1003000126`)
lookup	string	No	Set to `true` or `1` to look up provider details from the NPPES registry

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/us/npi?value=1003000126"

Response Fields

Field	Type	Description
valid	boolean	Whether the NPI passed Luhn checksum validation
npi	string	The normalized 10-digit NPI
checkDigit	string	The Luhn check digit (last digit)

Additional Fields (with lookup)

Field	Type	Description
found	boolean	Whether the NPI was found in NPPES
type	string	`Individual` or `Organization`
name	string \| null	Provider name (individual or organization)
credential	string \| null	Credential (e.g. MD, DO, DDS)
status	string \| null	Enumeration status (A = Active)
taxonomy	object \| null	Primary taxonomy with `code` and `description`
address	object \| null	Practice location address
phone	string \| null	Practice phone number
dataSource	string \| null	`nppes` when data was retrieved from the NPPES registry

Example Response

{
  "valid": true,
  "npi": "1003000126",
  "checkDigit": "6"
}

Example Response — with lookup

{
  "valid": true,
  "npi": "1003000126",
  "checkDigit": "6",
  "found": true,
  "type": "Individual",
  "name": "ARDALAN ENKESHAFI",
  "credential": "M.D.",
  "status": "A",
  "taxonomy": {
    "code": "207RG0100X",
    "description": "Internal Medicine, Gastroenterology"
  },
  "address": {
    "address": "6410 ROCKLEDGE DR STE 304",
    "city": "BETHESDA",
    "state": "MD",
    "postalCode": "208171841",
    "country": "US"
  },
  "phone": "443-602-6207",
  "dataSource": "nppes"
}

Example Response — invalid

{
  "valid": false
}