API reference

Provider search API

Find providers when you have a name or location but not yet an NPI. Directory search uses the same Bearer key, quotas, and response conventions as single-NPI lookup.

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

Endpoint

GET /api/v1/providers/search — requires last_name and/or organization_name. Optional filters include city, state, taxonomy code, and limit.

Typical flow

  1. User types in a directory or enrollment UI.
  2. Your backend calls provider search and shows candidates.
  3. User selects a row; you confirm with GET /api/v1/npi/{npi}.

Full parameter tables and metering notes live on the docs quickstart.

Example request
curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://healthproviderapi.com/api/v1/providers/search?last_name=Smith&limit=10"
Download OpenAPI spec