# HCRIS Hospital Staffing Decline Search

> HCRIS Hospital Staffing Decline Search is a paid API for AI agents from api.govparse.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-14).

Identifies hospitals whose staffing ratio (FTEs per bed or per discharge) dropped year-over-year using CMS HCRIS fiscal data, with filters for state, control type, bed count, and minimum decline threshold.

## Facts

- Endpoint: GET https://api.govparse.io/v1/hcris/staffing-decline/search
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hcris-hospital-staffing-decline-search-eee63b4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rrUcoC4q_C3UV3AlZNZtb

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 hcris-hospital-staffing-decline-search-eee63b4c
```

Example prompt: Show me all Texas hospitals with at least 100 beds where the FTE-per-bed ratio dropped by at least 10% in fiscal year 2023, sorted by biggest decline — I want to flag potential understaffing issues.

## When to prefer this

Use this endpoint when you need to detect hospital-level staffing deterioration signals from CMS public HCRIS records — particularly for investigative research, healthcare due diligence, or policy analysis. Prefer this over general hospital search endpoints when the specific question is year-over-year staffing ratio decline rather than overall hospital lookup. It joins CMS timely-care data via CCN for downstream enrichment.

## Known failure modes

- No results returned if filters are too restrictive (e.g. very high min_pct_drop combined with specific state)
- Invalid state code or CCN format returns an error or empty set
- Year filter references a year with no HCRIS data yet filed
- min_beds or min_pct_drop passed as wrong type may cause rejection
- Rate limiting or payment failure on x402 protocol returns 402 status

## How this service works

Which hospitals cut staffing year-over-year? Compares each CCN's latest HCRIS fiscal year to the prior on a staffing ratio (metric=fte_per_bed default, or fte_per_discharge) and returns those whose ratio DROPPED. Filter by state, min_pct_drop, year, ccn, name, control_type, min_beds. Returns latest/prior ratio, delta and pct_change — an understaffing tell. CCN joins CMS timely-care. CMS public-domain records.

## Output

Returns a list of hospitals whose staffing ratio dropped year-over-year, including each hospital's CCN, name, state, control type, latest fiscal year ratio, prior year ratio, absolute delta, and percent change — along with pagination metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "ccn": {
     "type": "string",
     "examples": [
      "450078"
     ],
     "description": "Provider CCN(s), CSV."
    },
    "name": {
     "type": "string",
     "examples": [
      "Memorial"
     ],
     "description": "Hospital name fragment."
    },
    "year": {
     "type": "string",
     "examples": [
      "2023"
     ],
     "description": "Restrict the LATEST fiscal year(s) compared, CSV."
    },
    "limit": {
     "type": "integer",
     "examples": [
      25
     ],
     "description": "Max rows (default 25, cap 100)."
    },
    "state": {
     "type": "string",
     "examples": [
      "TX"
     ],
     "description": "Hospital state code(s), CSV."
    },
    "metric": {
     "type": "string",
     "examples": [
      "fte_per_bed"
     ],
     "description": "fte_per_bed (default) | fte_per_discharge."
    },
    "offset": {
     "type": "integer",
     "examples": [
      0
     ],
     "description": "Rows to skip."
    },
    "min_beds": {
     "type": "string",
     "examples": [
      "100"
     ],
     "description": "Minimum beds in the latest year."
    },
    "control_type": {
     "type": "string",
     "examples": [
      "Proprietary"
     ],
     "description": "Type of control fragment."
    },
    "min_pct_drop": {
     "type": "string",
     "examples": [
      "10"
     ],
     "description": "Minimum YoY % drop in the ratio."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hcris-hospital-staffing-decline-search-eee63b4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)
