# Medicare Advantage & Part D Star Ratings Lookup

> Medicare Advantage & Part D Star Ratings Lookup 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 official CMS Medicare Star Ratings for Medicare Advantage (Part C) and Part D contracts, searchable by contract ID, organization name, type, or minimum star rating.

## Facts

- Endpoint: GET https://api.healthtravel-api.workers.dev/api/health/medicare-advantage-star?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/medicare-advantage-part-d-star-ratings-lookup-0f461b60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ICRb4sRj2gu9kPxx03TXS

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 medicare-advantage-part-d-star-ratings-lookup-0f461b60
```

Example prompt: Can you look up the CMS Medicare Advantage star ratings for all Humana contracts that have an overall rating of at least 4 stars?

## When to prefer this

Use this endpoint when you need authoritative CMS Medicare star ratings for Medicare Advantage (Part C) or Part D contracts — especially when filtering by insurer name, contract ID, organization type, or minimum star threshold. It is the right choice for benefits research, plan comparison, compliance checking, or any workflow requiring official government quality ratings for Medicare health plans.

## Known failure modes

- Invalid contract number format returns empty results or 404
- minStars value outside 1–5 range may return an error or empty set
- orgType string that doesn't match known CMS organization types returns no results
- Pagination offset beyond total records returns empty array
- Rate limiting or payment failure returns 402 or 429 error

## How this service works

Official CMS Medicare Star Ratings for Medicare Advantage (Part C) and Part D contracts from the newest Star Ratings Data Tables: contract number, organization type, contract and marketing name, parent organization, SNP flag, Part C summary, Part D summary and overall star rating (1-5, half stars). Search by contract ID, organization or parent name, organization type or minimum overall stars.

## Output

Returns a paginated list of Medicare contract records, each including: contract number, organization type, contract name, marketing name, parent organization, SNP flag, Part C summary star rating, Part D summary star rating, and overall star rating (1–5 in half-star increments), sourced from the latest official CMS Star Ratings Data Tables.

## 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": {
      "limit": {
       "type": "string",
       "description": "Contracts, 1 to 200 (default 50)"
      },
      "offset": {
       "type": "string",
       "description": "Skip this many (paging)"
      },
      "parent": {
       "type": "string",
       "description": "Text in parent organization / contract / marketing name, e.g. Humana"
      },
      "orgType": {
       "type": "string",
       "description": "Organization type contains, e.g. Local CCP, PDP, PFFS"
      },
      "contract": {
       "type": "string",
       "description": "Contract number, e.g. H0028"
      },
      "minStars": {
       "type": "string",
       "description": "Minimum overall (or Part D for PDPs) rating, e.g. 4"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/medicare-advantage-part-d-star-ratings-lookup-0f461b60/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)