API reference

NPI lookup API

Look up a single US NPI and receive a normalized provider payload. Same registry data as NPPES, with Bearer auth, documented errors, and cache metadata.

Get free API key

No credit card on free tierOpenAPI spec Postman collectionUS NPI Registry (NPPES) source dataNPI-1 and NPI-2

Endpoint

GET /api/v1/npi/{npi} — pass a ten-digit NPI in the path. Authenticate with Authorization: Bearer YOUR_API_KEY.

Response highlights

data — NPI, entity type (NPI-1 or NPI-2), status, name fields, addresses, taxonomies
meta — request ID and cache status for tracing
404 with npi_not_found when the identifier is not in the registry

See the interactive quickstart and field tables on the main documentation page. Compare with the free registry in our NPPES comparison guide.

Example request

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://healthproviderapi.com/api/v1/npi/1003000126"

Download OpenAPI spec