# CMS Timely and Effective Care Hospital Search

> CMS Timely and Effective Care Hospital Search is a paid API for AI agents from api.govparse.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-15).

Search CMS 'Timely and Effective Care' hospital performance measures by state, facility, measure ID, city, score range, or reporting period

## Facts

- Endpoint: GET https://api.govparse.io/v1/cms/timely-care/search
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cms-timely-and-effective-care-hospital-search-4cd4dda6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NTjosUQZFwnCCNdBezvd-

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 cms-timely-and-effective-care-hospital-search-4cd4dda6
```

Example prompt: Show me the latest CMS timely care scores for hospital emergency departments in Florida, specifically the OP_18b median ED time measure, sorted by score ascending so I can see which hospitals have the longest wait times — limit to the top 25 results.

## When to prefer this

Use this endpoint when you need structured, filterable access to CMS Timely and Effective Care hospital data — especially for emergency department performance metrics like OP_18b (median ED time) or OP_22 (left-without-being-seen). Prefer this over scraping CMS Care Compare directly when you need programmatic filtering by state, city, facility CCN, score range, or measure, and when you want clean, machine-readable JSON output. This is ideal for healthcare analytics dashboards, hospital benchmarking tools, or research workflows that require current CMS quality measure data without building a CMS data pipeline from scratch.

## Known failure modes

- No results returned if the measure ID, state, or facility_id does not match any CMS records
- Invalid date format for period_end returns an error or empty result
- Measure IDs not recognized by CMS (e.g. typos) return no data
- Overly restrictive min/max score ranges may return zero results
- Rate limiting or payment failure (x402) blocks access; $1.25 USDC per call must succeed
- offset beyond total result count returns empty array

## How this service works

How is a hospital's emergency department performing on CMS timely-care measures? Search CMS 'Timely and Effective Care - Hospital' by state, facility_id (CCN), measure (OP_18b median ED time, OP_22 left-without-being-seen, SEP_1...), condition, city, min/max score, reporting-period end, or latest_only. Returns per-hospital score, sample, measure period, and snapshot. CMS Care Compare public-domain records.

## Output

Returns an array of per-hospital records, each containing the facility name, CMS CCN (facility_id), measure ID, numeric score, sample size, reporting period dates, and snapshot date. Results reflect CMS Care Compare public-domain data and can be paginated via limit/offset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "city": {
     "type": "string",
     "examples": [
      "Miami"
     ],
     "description": "City fragment."
    },
    "sort": {
     "type": "string",
     "examples": [
      "score:desc"
     ],
     "description": "score | sample | period_end :asc|:desc."
    },
    "limit": {
     "type": "integer",
     "examples": [
      25
     ],
     "description": "Max rows (default 25, cap 100)."
    },
    "state": {
     "type": "string",
     "examples": [
      "FL"
     ],
     "description": "Hospital state code(s), CSV."
    },
    "offset": {
     "type": "integer",
     "examples": [
      0
     ],
     "description": "Rows to skip."
    },
    "measure": {
     "type": "string",
     "examples": [
      "OP_18b"
     ],
     "description": "Measure id(s), CSV (OP_18b, OP_22, SEP_1...)."
    },
    "condition": {
     "type": "string",
     "examples": [
      "Emergency Department"
     ],
     "description": "Condition fragment."
    },
    "max_score": {
     "type": "string",
     "examples": [
      "500"
     ],
     "description": "Maximum numeric score."
    },
    "min_score": {
     "type": "string",
     "examples": [
      "200"
     ],
     "description": "Minimum numeric score."
    },
    "period_end": {
     "type": "string",
     "examples": [
      "2025-06-30"
     ],
     "description": "Exact reporting-period end date (YYYY-MM-DD)."
    },
    "facility_id": {
     "type": "string",
     "examples": [
      "100001"
     ],
     "description": "CMS CCN(s), CSV."
    },
    "latest_only": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = only each facility×measure's most recent period."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cms-timely-and-effective-care-hospital-search-4cd4dda6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)