# Ranzani 2025 SOFA-2 Score Calculator

> Ranzani 2025 SOFA-2 Score Calculator is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Computes the Ranzani 2025 SOFA-2 score (0–24) across six organ systems using updated ventilatory, cardiovascular, and renal criteria including NIV/ECMO, vasopressor dose bands, and SpO2/FiO2 fallback.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/sofa_2
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ranzani-2025-sofa-2-score-calculator-945e6fa6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NAKj5GF7LGec2I2cEVsTt

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 ranzani-2025-sofa-2-score-calculator-945e6fa6
```

Example prompt: Calculate the Ranzani 2025 SOFA-2 score for my ICU patient: FiO2 0.5, SpO2 88%, on advanced ventilatory support but not ECMO, MAP 62 mmHg with no vasopressors, GCS 10, bilirubin 3.2 mg/dL, platelets 85 × 10⁹/L, creatinine 2.4 mg/dL, and not on RRT.

## When to prefer this

Use this endpoint when you need the updated Ranzani 2025 SOFA-2 formulation specifically — which differs from the original Vincent 1996 SOFA in its ventilatory support bands, SpO2/FiO2 fallback, and vasopressor dose thresholds. Prefer this over generic SOFA calculators when NIV/ECMO status, contemporary vasopressor banding, or SpO2-based respiratory scoring is clinically relevant.

## Known failure modes

- Missing required parameters (fio2, advanced_ventilatory_support, platelets, map_mm_hg, gcs) returns 400/validation error
- FiO2 provided as percent instead of fraction (e.g. 50 instead of 0.5) causes scoring band misclassification
- SpO2 ≥98 with no PaO2 provided — SpO2/FiO2 pathway not applicable per Ranzani 2025, may return error or default to 0
- GCS outside 3–15 integer range returns validation error
- MAP outside 20–180 range rejected
- Conflicting ECMO and respiratory values may cause unexpected scoring if ECMO flag not set correctly

## How this service works

Ranzani 2025 SOFA-2 from six organs 0-4 (brain, respiratory, cardiovascular, liver, kidney, hemostasis), max 24. Maps PaO2/FiO2 or SpO2/FiO2 with NIV/ECMO, MAP and vasopressor dose bands, caller-assigned GCS and delirium-drug flag, bilirubin, platelets, creatinine or urine rate, and RRT. Not Vincent 1996 SOFA and not a diagnosis.

## Output

Returns the total SOFA-2 score (0–24) and individual organ sub-scores (0–4 each) for brain/neurological, respiratory, cardiovascular, liver, kidney, and hemostasis domains, calculated per Ranzani 2025 criteria — not the original Vincent 1996 SOFA.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "fio2",
      "advanced_ventilatory_support",
      "platelets_10e9_l",
      "map_mm_hg",
      "gcs"
     ],
     "properties": {
      "gcs": {
       "type": "integer",
       "description": "Glasgow Coma Scale total as assigned by the caller (integer 3-15), including last pre-sedation GCS or the motor scale when the three-domain GCS cannot be evaluated. 15 scores 0; 13-14 scores 1; 9-12 scores 2; 6-8 scores 3; 3-5 scores 4. magent does not examine the patient."
      },
      "rrt": {
       "type": "boolean",
       "description": "Receiving renal replacement therapy or fulfilling published RRT criteria, including chronic use (Ranzani 2025). true or false when provided; absent is false. true scores kidney 4. Non-renal RRT is not scored; the caller assigns this flag."
      },
      "ecmo": {
       "type": "boolean",
       "description": "Respiratory ECMO of any form. true or false when provided; absent is false. true scores respiratory 4 regardless of PaO2/FiO2 or SpO2/FiO2 and does not by itself score cardiovascular points."
      },
      "fio2": {
       "type": "number",
       "description": "Inspired oxygen as a fraction (0.21-1.0), not a percent."
      },
      "spo2": {
       "type": "number",
       "description": "Pulse-oximetry SpO2 as a percent (50-97.9). Used with fio2 only when pao2_mm_hg is absent and SpO2 is <98 (Ranzani 2025). SpO2/FiO2 >300 scores 0; ≤300 scores 1; ≤250 scores 2; ≤200 with advanced ventilatory support scores 3; ≤120 with advanced ventilatory support or ECMO scores 4."
      },
      "map_mm_hg": {
       "type": "number",
       "description": "Mean arterial pressure in mm Hg (20-180). MAP <70 with no vasopressor or inotrope scores 1 unless a higher cardiovascular band applies. When vasoactive_unavailable is true, MAP ≥70 scores 0; 60-69 scores 1; 50-59 scores 2; 40-49 scores 3; <40 scores 4."
      },
      "pao2_mm_hg": {
       "type": "num
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ranzani-2025-sofa-2-score-calculator-945e6fa6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)