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

  1. Expose GET /api/v1/providers/search behind your directory UI.
  2. Refresh known rows via GET /api/v1/npi/{npi}.
  3. Nightly jobs call POST /api/v1/npi/bulk for reconciliation batches.
  4. Store request IDs on persisted rows for support callbacks.