# CMS Hospital General Information by State

> CMS Hospital General Information by State is a paid API for AI agents from api.healthtravel-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns CMS hospital general information including name, type, ownership, emergency services, star ratings, and quality measure counts for up to 50 hospitals in a given US state.

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/health/hospitallink-cms-ratings?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cms-hospital-general-information-by-state-1cc8c223
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_06Vzs25z3OJeAmY51FsVj

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-hospital-general-information-by-state-1cc8c223
```

Example prompt: Can you pull up CMS hospital ratings for all hospitals in Vermont — I want to see their star ratings, emergency services status, and how they compare to the national rate for mortality and safety? Show me up to 20 hospitals.

## When to prefer this

Choose this endpoint when you need structured CMS hospital quality data for a specific US state, including star ratings and national-rate comparisons for mortality, safety, and readmission. Prefer it over raw CMS data downloads when you need a lightweight, per-state API call without parsing large CSVs. Best for agents doing hospital discovery, quality benchmarking, or healthcare coverage analysis at the state level.

## Known failure modes

- Missing or invalid state code returns an error or empty result
- CMS may not publish an overall star rating for all hospitals, resulting in null overallStars
- Some hospitals may lack measure data for certain categories
- Max parameter outside 1-50 range may cause validation errors
- Data freshness depends on CMS publication schedule; may not reflect the most recent quarter

## How this service works

CMS Hospital General Information (data.cms.gov): hospital name, city, type, ownership, emergency services, overall star rating (1-5, when CMS publishes one) and counts of measures better, no different or worse than the national rate for mortality, safety and readmission. Up to 50 hospitals per state per call.

## Output

A JSON object containing the queried state, data source URL, timestamp, and an array of hospital records. Each record includes the hospital name, city, state, phone, facility ID, type, ownership, emergency services flag, overall CMS star rating (1-5 when published), and measure counts for mortality, safety, and readmission (broken into better, no different, and worse than national rate).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "state"
     ],
     "properties": {
      "max": {
       "type": "string",
       "description": "How many hospitals, 1 to 50 (default 10)"
      },
      "state": {
       "type": "string",
       "description": "Two-letter US state code, e.g. VT"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "via": "csv",
  "state": "VT",
  "source": "https://data.cms.gov/provider-data/dataset/xubh-q36u",
  "checkedAt": "2026-10-23T09:36:38.123Z",
  "hospitals": [
   {
    "city": "BARRE",
    "name": "CENTRAL VERMONT MEDICAL CENTER",
    "type": "Acute Care Hospitals",
    "phone": "(802) 371-4100",
    "state": "VT",
    "measures": {
     "safety": {
      "worse": 1,
      "better": 0,
      "noDifferent": 4
     },
     "mortality": {
      "worse": 0,
      "better": 1,
      "noDifferent": 5
     },
     "readmission": {
      "worse": 2,
      "better": 0,
      "noDifferent": 7
     }
    },
    "ownership": "Voluntary non-profit - Private",
    "facilityId": "470001",
    "overallStars": 3,
    "emergencyServices": true
   },
   {
    "city": "BURLINGTON",
    "name": "UNIV. OF VERMONT - FLETCHER ALLEN HEALTH CARE",
    "type": "Acute Care Hospitals",
    "phone": "(802) 847-0000",
    "state": "VT",
    "measures": {
     "safety": {
      "worse": 1,
      "better": 2,
      "noDifferent": 5
     },
     "mortality": {
      "worse": 0,
      "better": 2,
      "noDifferent": 6
     },
     "readmission": {
      "worse": 3,
      "better": 1,
      "noDifferent": 7
     }
    },
    "ownership": "Voluntary non-profit - Other",
    "facilityId": "470003",
    "overallStars": 4,
    "emergencyServices": true
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cms-hospital-general-information-by-state-1cc8c223/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthtravel-api.workers.dev](https://www.zero.xyz/host/api.healthtravel-api.workers.dev/llms.txt)