Skip to main content
GET
Search NPPES NPI Registry

Authorizations

X-API-Key
string
header
required

Query Parameters

first_name
string | null

Provider first name (exact match, local DB)

last_name
string | null

Provider last name (exact match, local DB)

organization_name
string | null

Organization name (substring, local DB)

taxonomy_code
string | null

NUCC taxonomy code (e.g. '207RC0000X' for Cardiology). Local DB only.

taxonomy_description
string | null

Taxonomy / specialty description (substring)

city
string | null

Practice address city

state
string | null

2-letter state code

Maximum string length: 2
postal_code
string | null

ZIP code (prefix match)

enumeration_type
string | null

NPI-1 (individual) or NPI-2 (organization)

facility_ccn
string | null

Filter to providers affiliated with a specific CCN-registered facility. Resolves CCN → Facility.npi and returns matching rows. Local DB only.

live
boolean
default:false

If true, query the live CMS NPPES API directly and skip the local table. Useful when the local copy is stale or for one-off lookups of brand-new NPIs.

limit
integer
default:20

Max results

Required range: 1 <= x <= 200
skip
integer
default:0

Results to skip

Required range: x >= 0

Response

Successful Response

NPI search results.

error
string | null

Error message if NPPES was unreachable

providers
NPIProviderSummary · object[]
result_count
integer
default:0

Total matching results from NPPES