Provider directory
Provider directory APIs for in-app search and sync jobs
Power member-facing directories and nightly reconciliation with the same normalized provider contract.
The problem
Directories drift when teams mix ad hoc NPPES scripts, CSV imports, and one-off lookup tools. Support cannot trace which payload version a row came from.
How Health Provider API helps
Search when identifiers are unknown, lookup when they are known, and bulk paths when you need batch refresh. Cache metadata and request IDs make directory incidents easier to debug.
Example workflow
- Expose
GET /api/v1/providers/searchbehind your directory UI. - Refresh known rows via
GET /api/v1/npi/{npi}. - Nightly jobs call
POST /api/v1/npi/bulkfor reconciliation batches. - Store request IDs on persisted rows for support callbacks.