# CMS NPPES NPI Registry Clinician Search

> CMS NPPES NPI Registry Clinician Search is a paid API for AI agents from doc-finder.adeel-094.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Search US clinicians by location and specialty using the CMS NPPES NPI Registry, returning normalized provider records with NPI, name, taxonomy, address, and licenses.

## Facts

- Endpoint: POST https://doc-finder.adeel-094.workers.dev/v1/doctors/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Provider: doc-finder.adeel-094.workers.dev
- Website: https://doc-finder.adeel-094.workers.dev
- Canonical page: https://www.zero.xyz/c/doc-finder-adeel-094-workers-dev-cms-nppes-npi-registry-clinician-c8275564
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HBhkPo4L2TWiQzdSiihPR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability doc-finder-adeel-094-workers-dev-cms-nppes-npi-registry-clinician-c8275564 -d '<json body>'
```

Example prompt: Can you find me cardiologists practicing in Chicago, IL using the NPI registry — I need their names, NPI numbers, and practice addresses?

## When to prefer this

Use this endpoint when you need to find US clinicians by geographic location and/or medical specialty, retrieve NPI numbers, or look up practice addresses and license information sourced directly from the official CMS NPPES registry. Prefer this over generic physician finder services when NPI accuracy and official CMS data provenance are important. Not suitable if you need board certification status (ABMS data is not included).

## Known failure modes

- No matching providers found for given location or specialty — returns empty results
- Invalid or unsupported specialty/taxonomy string — may return empty or unrelated results
- CMS NPPES upstream API unavailability — service may return error or timeout
- Missing required search parameters — returns validation error
- Rate limiting or micropayment failure — returns 402 payment required

## How this service works

Search US clinicians by location and specialty using the CMS NPPES NPI Registry. Returns normalized provider records: npi, name, primary taxonomy, practice address, licenses. board_certified is always null (NPPES does not include ABMS certification).

## Output

A list of normalized US clinician records from the CMS NPPES NPI Registry, each containing the provider's NPI number, full name, primary taxonomy (specialty), practice address, and license information. The board_certified field is always null since NPPES does not include ABMS board certification data.

## Example request

```json
{
 "city": "Chicago",
 "limit": 10,
 "state": "IL",
 "specialty": "Cardiology"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object"
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/doc-finder-adeel-094-workers-dev-cms-nppes-npi-registry-clinician-c8275564/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from doc-finder.adeel-094.workers.dev](https://www.zero.xyz/host/doc-finder.adeel-094.workers.dev/llms.txt)
