# CMS Hospital Quality Ratings Lookup

> CMS Hospital Quality Ratings Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.00288/call, status unknown (last checked 2026-09-14).

Look up CMS Care Compare hospital quality ratings (star ratings and domain scores) for Medicare-certified US hospitals by facility ID, state, city, or name

## Facts

- Endpoint: GET https://2s.io/api/health/hospital-quality
- Price: $0.00288/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cms-hospital-quality-ratings-lookup-7dbfdfad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0YuoYYHvjjLJH6Wx6nQOX

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-quality-ratings-lookup-7dbfdfad
```

Example prompt: Can you pull up the CMS hospital quality ratings for hospitals in Boston, MA — I want to see their overall star ratings and how they compare to the national average on safety of care and patient experience?

## When to prefer this

Use this endpoint when you need authoritative, CMS-sourced hospital quality data for Medicare-certified US hospitals — including star ratings and domain-level performance benchmarks. Prefer this over general web searches or third-party hospital review sites when you need structured, federal public-domain data comparable across all ~5,300 hospitals, searchable by facility ID, state, city, or partial name.

## Known failure modes

- Invalid or unknown facilityId returns empty results
- Invalid state code returns empty results or error
- No hospitals found matching name/city filter returns empty array
- Exceeding limit=100 may return validation error
- Offset beyond total record count returns empty results

## How this service works

CMS Care Compare hospital quality ratings — the data behind medicare.gov hospital ratings, for all ~5,300 Medicare-certified US hospitals. Look up by facilityId (CMS certification number), or filter by state, city, and name (partial match). Each row: facility id/name/address/phone, hospital type + ownership, emergency services, overall star rating (1-5), and per-domain measure summaries (mortality, safety of care, readmission, patient experience, timeliness, effectiveness) showing whether the hospital performs better/same/worse than the national average. Rows returned with CMS's documented column names. Public-domain federal data.

## Output

Returns rows of Medicare-certified hospital records with facility ID, name, address, phone, hospital type, ownership, emergency services flag, overall 1-5 star rating, and per-domain measure summaries (mortality, safety of care, readmission, patient experience, timeliness, effectiveness) each showing better/same/worse than national average, using CMS's documented column names.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "city": "Boston",
   "limit": 10,
   "state": "MA",
   "offset": 0
  }
 }
}
```

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "city": {
       "type": "string"
      },
      "name": {
       "type": "string",
       "description": "Hospital name, partial match."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1
      },
      "state": {
       "type": "string",
       "description": "2-letter state code."
      },
      "offset": {
       "type": "integer",
       "default": 0,
       "minimum": 0
      },
      "facilityId": {
       "type": "string",
       "description": "CMS certification number, e.g. \"030103\"."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cms-hospital-quality-ratings-lookup-7dbfdfad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)