# CMS Hospital Scorecard Lookup

> CMS Hospital Scorecard Lookup is a paid API for AI agents from www.x402pulse.dev, paid per call via x402, $0.035/call, status unknown (last checked 2026-10-12).

Returns CMS star rating, hospital type, ownership, emergency services, and quality comparisons (mortality, safety, readmissions) for any U.S. Medicare hospital, plus state rank and percentile.

## Facts

- Endpoint: GET https://www.x402pulse.dev/v1/health/hospital?utm_source=zero.xyz
- Price: $0.035/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cms-hospital-scorecard-lookup-ec15f241
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r1_F73Q44yHpyc7sA-qY8

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-scorecard-lookup-ec15f241
```

Example prompt: What's the CMS star rating and quality scorecard for Massachusetts General Hospital in MA — how does it compare to the national average on mortality, safety, and readmissions, and what's its rank among hospitals in Massachusetts?

## When to prefer this

Use this endpoint when you need official CMS government data on U.S. Medicare hospital quality, including star ratings, national comparisons, and state rankings. Prefer this over general web search when you need structured, comparable quality metrics sourced directly from CMS. Best for research, pre-procedure hospital vetting, or building healthcare comparison tools.

## Known failure modes

- Hospital not found by name/state — returns no match if name is ambiguous or misspelled
- Facility ID not recognized — returns error if CMS ID is invalid or not in CMS dataset
- Hospital not rated — some facilities lack sufficient data for a CMS star rating
- Missing required parameters — query must include either facility ID or both name and state
- State code invalid — two-letter state code must be a valid U.S. state abbreviation

## How this service works

Hospital scorecard for any U.S. Medicare hospital from the Centers for Medicare & Medicaid Services (CMS, the U.S. government agency): CMS overall star rating, type, ownership, emergency services, and how it compares with the national average on mortality, safety and readmissions (measures better, same, worse), plus its rank and percentile among rated hospitals in its state. Look up by CMS facility ID or name plus state. Not medical advice.

## Output

Returns the hospital's CMS overall star rating (1-5 stars), facility type, ownership category, whether emergency services are available, and quality comparisons vs. national average (better/same/worse) for mortality, safety of care, and readmissions, plus the hospital's rank and percentile among rated hospitals in its state.

## 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": [],
     "properties": {
      "id": {
       "type": "string",
       "description": "CMS facility ID"
      },
      "name": {
       "type": "string",
       "description": "Hospital name"
      },
      "state": {
       "type": "string",
       "description": "Two-letter state code"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "030103",
   "city": "Phoenix",
   "name": "Mayo Clinic Hospital",
   "state": "AZ",
   "netScore": 9,
   "starRating": 5,
   "vsNational": {
    "safety": {
     "same": 3,
     "worse": 0,
     "better": 4
    },
    "mortality": {
     "same": 6,
     "worse": 0,
     "better": 2
    },
    "readmissions": {
     "same": 7,
     "worse": 0,
     "better": 3
    }
   },
   "stateComparison": {
    "rank": 1,
    "percentile": 100,
    "ofRatedHospitals": 61
   }
  },
  "cached": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cms-hospital-scorecard-lookup-ec15f241/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402pulse.dev](https://www.zero.xyz/host/www.x402pulse.dev/llms.txt)