NPI+ Provider Enrichment (FHIR-ready) API
# NPI+ Provider Enrichment API - Complete Healthcare Provider Data & FHIR Integration ## What is NPI? The **National Provider Identifier (NPI)** is a unique 10-digit identifier assigned to all healthcare providers in the United States by the Centers for Medicare & Medicaid Services (CMS). Every doctor, nurse, hospital, clinic, and healthcare organization has an NPI that serves as their universal…
NPI+ Provider Enrichment (FHIR-ready) API endpoints
| Method | Endpoint | Description |
|---|---|---|
| 🚀 Quick Start - RapidAPI | ||
| GET |
Health Check /v1/health |
**First Step:** Verify the API is running and healthy. **Expected Response:** ```json { "status": "ok", "version": "0.1.0", "uptimeSec": 12345 } ``` **What to Check:** - Status… |
| Provider Search | ||
| GET |
Provider Search /v1/providers/search |
Advanced fuzzy search for healthcare providers. |
| Provider Lookup | ||
| GET |
Provider by NPI /v1/providers/{npi} |
Get enriched provider information by NPI |
| FHIR Resources | ||
| GET |
FHIR Bundle Generation /v1/providers/{npi}/fhir |
Get FHIR R4 bundle containing Practitioner, Organization, Location, PractitionerRole, and Endpoint resources |
| AI-Friendly Endpoints | ||
| GET |
aiProviderSearch /ai/providers.search |
AI search with taxonomy filter for cardiologists |
| GET |
aiFhirConversion /ai/providers.to_fhir |
Convert an NPI record into a compact FHIR R4 bundle for clinical/interop use. Returns only core linked resources: Practitioner/Organization/Location/PractitionerRole/Endpoint. |
| Taxonomy Reference | ||
| GET |
getTaxonomyCodesWithPagination /v1/taxonomy |
Get taxonomy codes with specific pagination |
| Bulk Operations | ||
| GET |
bulkStatistics /v1/bulk/stats |
Get bulk operations statistics including queue length, job counts, and processing metrics |
| POST |
submitBulkMatchJob /v1/providers/match:bulk |
Submit a bulk provider matching job with up to 100k rows |
| GET |
getBulkJobStatus /v1/providers/match:bulk/job_01J8T2ZQ7S9M6N7KAB |
Check the status of a bulk matching job |
| GET |
bulkHealthCheck /v1/bulk/health |
Check the health of bulk operations infrastructure (Redis, database, tables, queue) |
| Error Handling Examples | ||
| GET |
nonExistentNpi /v1/providers/9999999999 |
Example of 404 error for non-existent NPI |
| GET |
missingSearchParameters /v1/providers/search |
Example of 400 error when no search parameters are provided |
| GET |
invalidNpiFormat /v1/providers/123 |
Example of 400 error for invalid NPI format (should be 10 digits) |
NPI+ Provider Enrichment (FHIR-ready) API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $24.99 / month | — |
|
| ULTRA Recommended | $74.99 / month | — |
|
| MEGA | $149.99 / month | — |
|