# NPI Registry API

> Search US doctors, dentists and healthcare organizations by name, specialty or location

- Vendor: `npiregistryapi` · version 1.0 · category Medical · tags npi registry api, npi lookup api, doctor search api, healthcare provider api, nppes api, physician directory api, provider taxonomy api, dentist search api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/npiregistryapi
- This document: https://apiclay.com/docs/npiregistryapi.md
- OpenAPI 3.1: https://apiclay.com/api/npiregistryapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `npiregistryapi`
- Updated: 2026-11-18

## About

## NPI Registry API

Search the US National Plan and Provider Enumeration System: every doctor, dentist, nurse practitioner, pharmacy and healthcare organization with an NPI, with practice addresses, phone numbers and specialties.

Data comes from **npiregistry.cms.hhs.gov** (https://npiregistry.cms.hhs.gov). Every route below calls the source's own public endpoint directly and returns the upstream response unchanged.

### Routes

#### GET `/providers` - Search providers
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| first_name | query | string | no | Individual's first name; `*` wildcard after 2 letters. |
| last_name | query | string | no | Individual's last name. |
| organization_name | query | string | no | Organization name. |
| taxonomy_description | query | string | no | Specialty, e.g. `Dentist`, `Family Medicine`. |
| enumeration_type | query | string | no | `NPI-1` (individual) or `NPI-2` (organization). |
| city | query | string | no | City. |
| state | query | string | no | 2-letter state, e.g. `TX`. |
| postal_code | query | string | no | 5 or 9 digit ZIP; `*` wildcard allowed. |
| country_code | query | string | no | e.g. `US`. |
| limit | query | number | no | Results, up to 200 (default 10). |
| skip | query | number | no | Offset, up to 1000. |

At least one search field besides `limit`/`skip` is needed.

Returns: `result_count`, `results[]` with `number` (NPI), `enumeration_type`, `basic` (name, credential, status), `addresses[]` (location and mailing, phone), `taxonomies[]` (code, desc, primary, license).

#### GET `/provider` - One provider
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| number | query | string | yes | 10-digit NPI, e.g. `1154494250`. |

Returns: the same record shape for that NPI.

### License

NPPES data is published by CMS and is in the public domain.

### Caveats

- Results are capped at 1,200 per search (limit 200 x skip 1000); narrow by state or city.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by npiregistry.cms.hhs.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /providers — Search providers
- Gateway: `GET https://api.apiclay.com/v1/api/npiregistryapi/providers`
- Public query params: `first_name` (string), `last_name` (string), `organization_name` (string), `taxonomy_description` (string), `enumeration_type` (string), `city` (string), `state` (string), `postal_code` (string), `country_code` (string), `limit` (string), `skip` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /provider — Provider by NPI number
- Gateway: `GET https://api.apiclay.com/v1/api/npiregistryapi/provider`
- Public query params: `number` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/npiregistryapi/providers" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
