# HealthParse SNF Quality Search

> HealthParse SNF Quality Search is a paid API for AI agents from api.healthparse.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Search skilled nursing facility (SNF) quality data from CMS Care Compare by state, city, ZIP, or star rating to identify facilities meeting quality thresholds in a market.

## Facts

- Endpoint: GET https://api.healthparse.io/v1/facilities/snf/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthparse-snf-quality-search-0fb01803
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ka0f-z_Aj3pyK5kd_cgE7

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 healthparse-snf-quality-search-0fb01803
```

Example prompt: Can you find skilled nursing facilities in Denver, Colorado with a CMS overall star rating of at least 4, and show me the top 25 results?

## When to prefer this

Use this endpoint when you need to search and filter skilled nursing facilities across a geographic area (state, city, or ZIP) and want to apply CMS star rating thresholds. Prefer this over the single-CCN SNF lookup when you don't yet know the specific facility CCN and need to discover facilities meeting quality criteria in a market. Use the companion SNF detail endpoint for deep quality metrics once you have a CCN.

## Known failure modes

- No facilities match the filters (empty result set returned)
- Invalid state abbreviation or city name returns empty or error response
- overall_rating_min greater than overall_rating_max causes invalid filter
- ZIP prefix not found returns empty results
- Exceeding limit of 100 triggers validation error
- API returns stale data if monthly CMS refresh is pending

## How this service works

Search snf quality data by state, city, ZIP, or CMS star rating. Answers: which snf meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh.

## Output

A paginated list of skilled nursing facilities matching the search criteria, including facility names, locations, CMS overall star ratings, and related quality identifiers sourced from CMS Care Compare with monthly data refresh.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "city": {
     "type": "string"
    },
    "limit": {
     "type": "integer",
     "default": 25,
     "maximum": 100
    },
    "state": {
     "type": "string"
    },
    "offset": {
     "type": "integer",
     "default": 0
    },
    "zip_prefix": {
     "type": "string"
    },
    "overall_rating_max": {
     "type": "number"
    },
    "overall_rating_min": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthparse-snf-quality-search-0fb01803/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthparse.io](https://www.zero.xyz/host/api.healthparse.io/llms.txt)