HOSPITAL score

HOSPITAL

Sum the Donze 2013 HOSPITAL integer score (acronym table, max 13) from caller-assigned flags and prior-year admissions and return the derivation-study band (low / intermediate / high).

LIVE $0.005 USDC GET /api/calc/hospital

Markdown: /docs/hospital.md · Canonical: https://magentlab.com/docs/hospital

Not a medical device. Not a diagnosis, dose, or listing recommendation.

What it computes

Sum the Donze 2013 HOSPITAL integer score (acronym table, max 13) from caller-assigned flags and prior-year admissions and return the derivation-study band (low / intermediate / high).

When to use

When an agent needs the published HOSPITAL point total and must not invent a discharge order, a diagnosis, or a measured 30-day readmission percent.

When not to use

Not a medical device and not a discharge, admission, or follow-up order. magent does not examine the patient or read the chart.
Not a diagnosis. The published outcome is potentially avoidable 30-day readmission (SQLape), not all-cause readmission.
Hemoglobin <12 g/dL and sodium <135 mmol/L are caller-assigned flags. magent does not assay labs or accept hemoglobin or sodium numbers.
Risk bands 0–4 low, 5–6 intermediate, ≥7 high follow the Donze 2013 derivation study. magent returns the band only, not a measured readmission percent for this discharge.

Formula

HOSPITAL = hemoglobin_lt_12 (1) + oncology_service (2) + sodium_lt_135 (1) + procedure (1) + urgent_or_emergent_admission (1) + admissions_12mo (0-1: 0, 2-5: 2, >5: 5) + los_ge_5_days (2); Donze 2013 acronym table; max 13; 0-4 low, 5-6 intermediate, >=7 high

Citation

Title: Potentially Avoidable 30-Day Hospital Readmissions in Medical Patients: Derivation and Validation of a Prediction Model
Authors: Donze J, Aujesky D, Williams D, Schnipper JL
Source: JAMA Intern Med. 2013;173(8):632-638
DOI: 10.1001/jamainternmed.2013.3023

Worked example

All flags absent, no prior-year admissions

Given: admissions_12mo=0hemoglobin_lt_12=falselos_ge_5_days=falseoncology_service=falseprocedure=falsesodium_lt_135=falseurgent_or_emergent_admission=false

All HOSPITAL flags false; admissions_12mo 0 → 0
Score = 0 (max 13); risk_band low

All HOSPITAL items at published maximum

Given: admissions_12mo=6hemoglobin_lt_12=truelos_ge_5_days=trueoncology_service=trueprocedure=truesodium_lt_135=trueurgent_or_emergent_admission=true

H 1 + O 2 + S 1 + P 1 + I 1 + A >5 → 5 + L 2
Score = 13 (max 13); risk_band high. Band only; not a measured percent.

Also searched as

HOSPITAL score
HOSPITAL index
Donze HOSPITAL
hospital readmission score
potentially avoidable readmission
HOSPITAL 2013

Try

Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.

/api/calc/hospital?hemoglobin_lt_12=false&oncology_service=false&sodium_lt_135=false&procedure=false&urgent_or_emergent_admission=false&admissions_12mo=0&los_ge_5_days=false

Full URL: https://api.magentlab.com/api/calc/hospital?hemoglobin_lt_12=false&oncology_service=false&sodium_lt_135=false&procedure=false&urgent_or_emergent_admission=false&admissions_12mo=0&los_ge_5_days=false

Call

Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params return HTTP 400 before any quote or charge.

curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/hospital?hemoglobin_lt_12=false&oncology_service=false&sodium_lt_135=false&procedure=false&urgent_or_emergent_admission=false&admissions_12mo=0&los_ge_5_days=false"

Parameters

Name	Type	Required	Description
`hemoglobin_lt_12`	boolean	required	Last hemoglobin <12 g/dL as assigned by the caller (Donze 2013 H). true scores 1. magent does not assay hemoglobin. Do not send a hemoglobin number.
`oncology_service`	boolean	required	Discharge from an oncology service as assigned by the caller (Donze 2013 O). true scores 2.
`sodium_lt_135`	boolean	required	Last sodium <135 mmol/L as assigned by the caller (Donze 2013 S). true scores 1. magent does not assay sodium. Do not send a sodium number.
`procedure`	boolean	required	Any ICD-coded procedure during the stay as assigned by the caller (Donze 2013 P). true scores 1. magent does not read the chart.
`urgent_or_emergent_admission`	boolean	required	Index admission type urgent or emergent, not elective, as assigned by the caller (Donze 2013 I). true scores 1.
`admissions_12mo`	integer	required	Hospital admissions during the previous year (integer 0-50, magent clamp). Donze 2013 A: 0-1 scores 0; 2-5 scores 2; >5 scores 5. Count 0 and 1 both score 0; 2 scores 2; 5 scores 2; 6 scores 5.
`los_ge_5_days`	boolean	required	Length of stay ≥5 days as assigned by the caller (Donze 2013 L). true scores 2. magent does not compute length of stay from dates.

Bulk (POST)

POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.

POST /api/calc/hospital Max 25 unit_amount + extra_item_amount * (n - 1) extra $0.002 PREVIEW

1 to 25 items. Each item uses the same keys as the GET query parameters.
POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.

Example request (fixture)

{
  "items": [
    {
      "admissions_12mo": "0",
      "hemoglobin_lt_12": "false",
      "los_ge_5_days": "false",
      "oncology_service": "false",
      "procedure": "false",
      "sodium_lt_135": "false",
      "urgent_or_emergent_admission": "false"
    },
    {
      "admissions_12mo": "0",
      "hemoglobin_lt_12": "false",
      "los_ge_5_days": "false",
      "oncology_service": "false",
      "procedure": "false",
      "sodium_lt_135": "false",
      "urgent_or_emergent_admission": "false"
    }
  ]
}

Open bulk paywall →

Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.

Example 200 (fixture)

{
  "count": 2,
  "path": "/api/calc/hospital",
  "items": [
    {
      "components": [
        {
          "factor": "hemoglobin_lt_12",
          "points": 0,
          "present": false
        },
        {
          "factor": "oncology_service",
          "points": 0,
          "present": false
        },
        {
          "factor": "sodium_lt_135",
          "points": 0,
          "present": false
        },
        {
          "factor": "procedure",
          "points": 0,
          "present": false
        },
        {
          "factor": "urgent_or_emergent_admission",
          "points": 0,
          "present": false
        },
        {
          "value": 0,
          "factor": "admissions_12mo",
          "points": 0,
          "present": false
        },
        {
          "factor": "los_ge_5_days",
          "points": 0,
          "present": false
        }
      ],
      "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
      "citation": {
        "authors": "Donze J, Aujesky D, Williams D, Schnipper JL",
        "doi": "10.1001/jamainternmed.2013.3023",
        "id": "donze-2013",
        "pmid": "23529115",
        "source": "JAMA Intern Med. 2013;173(8):632-638",
        "title": "Potentially Avoidable 30-Day Hospital Readmissions in Medical Patients: Derivation and Validation of a Prediction Model"
      },
      "formula": "hospital",
      "formula_expression": "HOSPITAL = hemoglobin_lt_12 (1) + oncology_service (2) + sodium_lt_135 (1) + procedure (1) + urgent_or_emergent_admission (1) + admissions_12mo (0-1: 0, 2-5: 2, >5: 5) + los_ge_5_days (2); Donze 2013 acronym table; max 13; 0-4 low, 5-6 intermediate, >=7 high",
      "max_score": 13,
      "score": 0,
      "risk_band": "low",
      "admissions_12mo": 0
    },
    {
      "components": [
        {
          "factor": "hemoglobin_lt_12",
          "points": 0,
          "present": false
        },
        {
          "factor": "oncology_service",
          "points": 0,
          "present": false
        },
        {
          "factor": "sodium_lt_135",
          "points": 0,
          "present": false
        },
        {
          "factor": "procedure",
          "points": 0,
          "present": false
        },
        {
          "factor": "urgent_or_emergent_admission",
          "points": 0,
          "present": false
        },
        {
          "value": 0,
          "factor": "admissions_12mo",
          "points": 0,
          "present": false
        },
        {
          "factor": "los_ge_5_days",
          "points": 0,
          "present": false
        }
      ],
      "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
      "citation": {
        "authors": "Donze J, Aujesky D, Williams D, Schnipper JL",
        "doi": "10.1001/jamainternmed.2013.3023",
        "id": "donze-2013",
        "pmid": "23529115",
        "source": "JAMA Intern Med. 2013;173(8):632-638",
        "title": "Potentially Avoidable 30-Day Hospital Readmissions in Medical Patients: Derivation and Validation of a Prediction Model"
      },
      "formula": "hospital",
      "formula_expression": "HOSPITAL = hemoglobin_lt_12 (1) + oncology_service (2) + sodium_lt_135 (1) + procedure (1) + urgent_or_emergent_admission (1) + admissions_12mo (0-1: 0, 2-5: 2, >5: 5) + los_ge_5_days (2); Donze 2013 acronym table; max 13; 0-4 low, 5-6 intermediate, >=7 high",
      "max_score": 13,
      "score": 0,
      "risk_band": "low",
      "admissions_12mo": 0
    }
  ]
}

Response

Field	Type	Description
`formula`	string	hospital
`formula_expression`	string	Exact expression used
`score`	integer	HOSPITAL points 0-13 (Donze 2013)
`max_score`	integer	Always 13
`risk_band`	string	Donze 2013 derivation band: low (0-4), intermediate (5-6), or high (>=7). A band, not a measured readmission percent for this discharge.
`admissions_12mo`	integer	Prior-year hospital admission count used for Donze 2013 A
`components`	array	Per-factor HOSPITAL acronym points
`citation`	object	Donze et al. JAMA Intern Med 2013 citation
`disclaimer`	string	Not-a-device notice

Example JSON

Machine form of the same example. Frozen fixture. Not a live lookup.

{
  "components": [
    {
      "factor": "hemoglobin_lt_12",
      "points": 0,
      "present": false
    },
    {
      "factor": "oncology_service",
      "points": 0,
      "present": false
    },
    {
      "factor": "sodium_lt_135",
      "points": 0,
      "present": false
    },
    {
      "factor": "procedure",
      "points": 0,
      "present": false
    },
    {
      "factor": "urgent_or_emergent_admission",
      "points": 0,
      "present": false
    },
    {
      "value": 0,
      "factor": "admissions_12mo",
      "points": 0,
      "present": false
    },
    {
      "factor": "los_ge_5_days",
      "points": 0,
      "present": false
    }
  ],
  "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
  "citation": {
    "authors": "Donze J, Aujesky D, Williams D, Schnipper JL",
    "doi": "10.1001/jamainternmed.2013.3023",
    "id": "donze-2013",
    "pmid": "23529115",
    "source": "JAMA Intern Med. 2013;173(8):632-638",
    "title": "Potentially Avoidable 30-Day Hospital Readmissions in Medical Patients: Derivation and Validation of a Prediction Model"
  },
  "formula": "hospital",
  "formula_expression": "HOSPITAL = hemoglobin_lt_12 (1) + oncology_service (2) + sodium_lt_135 (1) + procedure (1) + urgent_or_emergent_admission (1) + admissions_12mo (0-1: 0, 2-5: 2, >5: 5) + los_ge_5_days (2); Donze 2013 acronym table; max 13; 0-4 low, 5-6 intermediate, >=7 high",
  "max_score": 13,
  "score": 0,
  "risk_band": "low",
  "admissions_12mo": 0
}

Client errors (HTTP 400)

Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.

HTTP	Code	When
400	`invalid_flag`	boolean clinical flags must be true or false Returned before settlement; you are not charged.
400	`invalid_admissions_12mo`	admissions_12mo must be an integer from 0 to 50 (Donze 2013 prior-year count; magent clamp). Returned before settlement; you are not charged.
400	`invalid_hospital`	each HOSPITAL 2013 item must be a published value for that field. Returned before settlement; you are not charged.
400	`invalid_items`	POST body must be a JSON object with only an items array Returned before settlement; you are not charged.
400	`invalid_item_count`	items must be an array of 1 to 25 objects Returned before settlement; you are not charged.
400	`invalid_item`	each items entry must be a JSON object Returned before settlement; you are not charged.

Related tools

LACE — Sum van Walraven 2010 Table 3 LACE points from length of stay, acute (emergent) admission, a caller-supplied Charlson integer, and ED visits in the previous 6 months.

Payment

Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake and shared payment errors: Payments. Stdio MCP: /docs/mcp.

Guarantees

HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
Execution is timeout-bounded and concurrency-capped.
Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.