# HealthParse Medicare Provider Search

> HealthParse Medicare Provider Search is a paid API for AI agents from api.healthparse.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Search and filter Medicare providers by NPI, state, specialty, service volume, beneficiary count, or payment amounts using CMS Medicare claims data.

## Facts

- Endpoint: GET https://api.healthparse.io/v1/providers/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthparse-medicare-provider-search-42d7f541
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5AKtbSTnwx9ID7c0vhI-d

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 healthparse-medicare-provider-search-42d7f541
```

Example prompt: Find me Medicare providers in Texas who specialize in cardiology, saw at least 500 beneficiaries, and received more than $200,000 in total payments — show me the top 25 results.

## When to prefer this

Use this endpoint when you need to discover, filter, or analyze Medicare providers from CMS claims data across dimensions like specialty, geography, billing volume, beneficiary count, or payment amounts. Prefer this over general provider directories when Medicare-specific activity data (services, beneficiaries, payments) is required for market analysis, competitive intelligence, or provider identification.

## Known failure modes

- Invalid NPI format returns empty results or validation error
- State code not recognized returns no results
- Specialty string does not match CMS taxonomy returns no results
- Min value exceeds max value for range filters causes error or empty result
- Offset beyond result set returns empty array
- Rate limit or payment failure returns 402 or 429 error

## How this service works

Search Medicare providers by NPI, state, specialty, service volume, beneficiaries, or payments. Answers: which providers in a market match this specialty, volume, or beneficiary profile? Source: CMS Medicare claims.

## Output

A paginated list of Medicare provider records matching the search criteria, including NPI, specialty, state, total services rendered, total beneficiaries served, and total Medicare payments received, sourced from CMS Medicare claims data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "npi": {
     "type": "string"
    },
    "limit": {
     "type": "integer",
     "default": 25,
     "maximum": 100
    },
    "state": {
     "type": "string"
    },
    "offset": {
     "type": "integer",
     "default": 0
    },
    "specialty": {
     "type": "string"
    },
    "total_payment_max": {
     "type": "number"
    },
    "total_payment_min": {
     "type": "number"
    },
    "total_services_max": {
     "type": "number"
    },
    "total_services_min": {
     "type": "number"
    },
    "total_beneficiaries_max": {
     "type": "number"
    },
    "total_beneficiaries_min": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthparse-medicare-provider-search-42d7f541/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthparse.io](https://www.zero.xyz/host/api.healthparse.io/llms.txt)