# hospital-price-lookup

> hospital-price-lookup is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Retrieves negotiated, gross, and cash prices a hospital publishes for a given procedure billing code, fused with CMS Care Compare quality data, streamed from the hospital's machine-readable file.

## Facts

- Endpoint: GET https://payai.agentstools.dev/price/hospital
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hospital-price-lookup-629646f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o1pPyOQJ8EcYaSN1MD0so

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 hospital-price-lookup-629646f8
```

Example prompt: What does St. Mary's Hospital charge for a total knee replacement — CPT code 27447 — including their negotiated rate with Blue Cross and their cash price? Pull it from their machine-readable file at stmarys.org and include CMS quality scores if you can find their CCN.

## When to prefer this

Use this endpoint when you need to retrieve actual hospital-published transparency prices for a specific procedure code from a specific hospital's CMS-mandated machine-readable file, optionally enriched with quality data. Prefer this over generic insurance cost estimators when you need sourced, citable pricing from the hospital's own disclosure. Best when you have the MRF URL (from a discovery step) or the hospital's domain and a known billing code.

## Known failure modes

- Billing code not found in MRF — no matching entry returned
- MRF URL unreachable or malformed — file fetch fails
- Hospital domain MRF auto-discovery fails — no MRF link found on site
- Payer filter returns zero matching negotiated rates
- CCN not recognized by CMS Care Compare — quality data omitted
- Rate-limiting or timeouts when streaming large MRF files
- Invalid or unsupported code_type enum value

## How this service works

Negotiated, gross and cash prices a hospital publishes for a procedure code, plus fused CMS Care Compare quality. Streams the slice of the hospital's own machine-readable file for one billing code and cites the file's hospital name, date and version. Informational, not a quote.

## Output

A structured slice of the hospital's machine-readable pricing file for the requested billing code, including gross charge, negotiated rates (optionally filtered by payer), and cash/discounted price. Also includes hospital name, MRF file date and version for citation, and optionally fused CMS Care Compare quality metrics when a CCN is supplied. Response is informational, not a binding quote.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "code"
     ],
     "properties": {
      "ccn": {
       "type": "string",
       "description": "Optional 6-digit CMS Certification Number to fuse Care Compare quality"
      },
      "code": {
       "type": "string",
       "description": "Procedure billing code to look up, e.g. 27447"
      },
      "payer": {
       "type": "string",
       "description": "Optional payer or plan name substring to filter the returned negotiated rates"
      },
      "domain": {
       "type": "string",
       "description": "Hospital domain to auto-discover the MRF instead of mrf_url"
      },
      "mrf_url": {
       "type": "string",
       "description": "The hospital machine-readable-file URL (from /price/discover)"
      },
      "code_type": {
       "type": "array",
       "items": {
        "enum": [
         "CPT",
         "HCPCS",
         "MS-DRG",
         "DRG",
         "APC",
         "NDC",
         "ICD-10",
         "CDM",
         "local"
        ],
        "type": "string"
       },
       "description": "Optional billing-code system(s) to constrain the match"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hospital-price-lookup-629646f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)