# HealthParse National Price Stats by Billing Code

> HealthParse National Price Stats by Billing Code is a paid API for AI agents from api.healthparse.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns national median and spread of payer-negotiated rates for a given billing code (CPT/HCPCS/MS-DRG) derived from hospital price-transparency files

## Facts

- Endpoint: GET https://api.healthparse.io/v1/prices/stats/:code
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthparse-national-price-stats-by-billing-code-f72db16a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4t7kCb_1XOcLy0sHtJz4P

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-national-price-stats-by-billing-code-f72db16a
```

Example prompt: What's a fair negotiated rate for CPT code 99213 based on national hospital price transparency data — give me the median and spread across payers.

## When to prefer this

Use this endpoint when you need national benchmark pricing for a specific medical procedure or service identified by a standard billing code (CPT, HCPCS, or MS-DRG). Ideal for cost transparency, healthcare price comparison, insurance negotiation research, or patient cost estimation. Prefer this over individual hospital price lookups when you want an aggregated national view of what payers actually negotiate.

## Known failure modes

- Unknown or invalid billing code returns 404 or empty result
- Code ambiguous across billing types returns stats_by_type array instead of flat row — agent must check for this field
- No price data available for rare or new codes
- Malformed code format may return 400 bad request
- Rate data may be stale if hospital price transparency files have not been recently updated

## How this service works

National price statistics for a billing code (CPT/HCPCS/MS-DRG) from hospital price-transparency files: median and spread of payer-negotiated rates. Answers: what is a fair price for this procedure? Shape varies: a code under one billing_code_type (common case) returns the flat row shown below; a code ambiguous across types instead returns { billing_code, stats_by_type: [...] } — check for a top-level stats_by_type array to tell them apart.

## Output

A JSON object containing the billing code, its type (CPT/HCPCS/MS-DRG), and national statistics including median payer-negotiated rate and rate spread. If the code is unambiguous under one billing_code_type, returns a flat row; if the code maps across multiple types, returns a top-level stats_by_type array with per-type statistics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {}
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthparse-national-price-stats-by-billing-code-f72db16a/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)