# HealthParse Hospital Search

> HealthParse Hospital 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 US hospitals by geographic and financial/operational criteria using CMS HCRIS cost report data

## Facts

- Endpoint: GET https://api.healthparse.io/v1/hospitals/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-hospital-search-ae2eb80f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s1VIagnqGr_RDIqcaOSQ0

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-hospital-search-ae2eb80f
```

Example prompt: Find me nonprofit acute care hospitals in Texas with at least 100 beds, more than 5,000 discharges, and an operating margin above 5% — pull up to 50 results from the most recent fiscal year.

## When to prefer this

Use this endpoint when you need to screen or rank US hospitals by financial or operational criteria across a geographic market — especially when combining location filters (state, city, ZIP) with financial thresholds (revenue, margin, discharges) or facility characteristics (beds, hospital type, control type). Prefer this over the single-hospital history endpoint when you need a broad market overview rather than one institution's time-series. CMS HCRIS data is authoritative for cost and volume metrics.

## Known failure modes

- No hospitals match the specified filter combination — returns empty results list
- Invalid state abbreviation or unrecognized control_type/hospital_type enum value — may return 400 or empty results
- Offset beyond total result count returns empty page
- fy_end_year outside available data range returns no results
- Rate limit or payment failure returns 402 or 429

## How this service works

Search US hospitals by state, city, type, control, beds, discharges, revenues, or operating margin. Answers: which hospitals in a market match a financial or operational profile? Source: CMS cost reports (HCRIS 2552-10).

## Output

A paginated list of US hospitals matching the specified filters, each record including hospital name, CCN, location (city, state, ZIP), hospital type, control type, bed count, total discharges, total revenues, and operating margin — all sourced from CMS HCRIS cost reports.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "city": {
     "type": "string"
    },
    "limit": {
     "type": "integer",
     "default": 25,
     "maximum": 100
    },
    "state": {
     "type": "string"
    },
    "offset": {
     "type": "integer",
     "default": 0
    },
    "zip_prefix": {
     "type": "string"
    },
    "fy_end_year": {
     "type": "integer"
    },
    "name_search": {
     "type": "string"
    },
    "control_type": {
     "type": "string"
    },
    "hospital_type": {
     "type": "string"
    },
    "total_beds_max": {
     "type": "number"
    },
    "total_beds_min": {
     "type": "number"
    },
    "total_revenues_max": {
     "type": "number"
    },
    "total_revenues_min": {
     "type": "number"
    },
    "operating_margin_max": {
     "type": "number"
    },
    "operating_margin_min": {
     "type": "number"
    },
    "total_discharges_max": {
     "type": "number"
    },
    "total_discharges_min": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthparse-hospital-search-ae2eb80f/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)