# REVEAL 2.0 PAH 12-Month Mortality Risk Calculator

> REVEAL 2.0 PAH 12-Month Mortality Risk 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-14).

Computes the Benza 2019 REVEAL 2.0 score and risk stratum (low/intermediate/high) for 12-month mortality in pulmonary arterial hypertension patients.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/reveal_pah
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reveal-2-0-pah-12-month-mortality-risk-calculator-0e4a3e52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R_LqF_gapQYnFSM1QQMQT

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 reveal-2-0-pah-12-month-mortality-risk-calculator-0e4a3e52
```

Example prompt: Calculate the REVEAL 2.0 score for a 64-year-old male with CTD-associated PAH, WHO functional class III, BNP of 320 pg/mL, 6-minute walk distance of 280 meters, heart rate above 96, systolic BP above 110, no renal insufficiency, no hospitalization in the last 6 months, no pericardial effusion, DLCO not below 40%, mean RAP not above 20, and PVR not below 5 Wood units.

## When to prefer this

Use this endpoint when you need to apply the specific Benza 2019 REVEAL 2.0 scoring algorithm (not REVEAL 1.0 or REVEAL Lite 2) for 12-month mortality risk stratification in PAH. Prefer this over manual calculation when integrating PAH risk scoring into clinical decision support workflows, EHR pipelines, or research tools that require a consistent, auditable computation with defined inputs and a structured low/intermediate/high output.

## Known failure modes

- Missing required parameters (e.g. omitting both bnp_pg_ml and nt_probnp_pg_ml) returns a validation error
- Invalid WHO functional class value outside 1–4 returns a parameter error
- Age outside 18–120 range rejected
- BNP value outside 0–35000 pg/mL range rejected
- Incorrect etiology enum value returns 400 error
- Network or payment (x402) failure prevents score from being returned

## How this service works

Benza 2019 REVEAL 2.0: start at 6; add published points for etiology (CTD +1, PoPH +3, heritable +2), male >60, renal insufficiency, WHO FC, 6-month hospitalization, SBP <110, HR >96, 6MWD, BNP/NT-proBNP, pericardial effusion, DLCO <40%, mRAP >20, and PVR <5. Returns low (0-6), intermediate (7-8), or high (>=9) 12-month mortality. Caller-assigned; not a PAH diagnosis or dose. Not REVEAL 1.0 or Lite 2.

## Output

Returns the computed REVEAL 2.0 integer total score and a categorical 12-month mortality risk stratum: low (score 0–6), intermediate (7–8), or high (≥9). Does not provide a PAH diagnosis, treatment recommendation, or dosing guidance.

## 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": [
      "who_fc",
      "etiology",
      "age",
      "male",
      "renal_insufficiency",
      "hospitalization_6mo",
      "sbp_lt_110",
      "hr_gt_96",
      "six_minute_walk_m",
      "bnp_pg_ml",
      "pericardial_effusion",
      "dlco_lt_40",
      "mrap_gt_20",
      "pvr_lt_5"
     ],
     "properties": {
      "age": {
       "type": "integer",
       "description": "Age in years (18-120). Male and age >60 scores +2 (Benza 2019)."
      },
      "male": {
       "type": "boolean",
       "description": "Male sex as assigned by the caller. true or false. Scores +2 only when age >60."
      },
      "who_fc": {
       "type": "integer",
       "description": "WHO / NYHA functional class 1, 2, 3, or 4 (Benza 2019). FC I -1; II 0; III +1; IV +2. Caller-assigned; magent does not interview the patient."
      },
      "etiology": {
       "enum": [
        "other",
        "ctd",
        "poph",
        "heritable"
       ],
       "type": "string",
       "description": "PAH subgroup (Benza 2019). other (including idiopathic) 0; ctd +1; poph +3; heritable +2. Mutually exclusive. Caller-assigned."
      },
      "hr_gt_96": {
       "type": "boolean",
       "description": "Heart rate >96 bpm as assigned by the caller (Benza 2019 REVEAL 2.0, not the 1.0 >92 cutoff). true or false. +1 if true."
      },
      "pvr_lt_5": {
       "type": "boolean",
       "description": "Pulmonary vascular resistance <5 Wood units as assigned by the caller (Benza 2019 REVEAL 2.0, not the 1.0 >32 WU band). true or false. -1 if true."
      },
      "bnp_pg_ml": {
       "type": "number",
       "description": "BNP in pg/mL 0-35000 (Benza 2019). <50 -2; 50-<200 0; 200-<800 +1; >=800 +2. Omit only when sending nt_probnp_pg_ml instead. magent does not assay BNP."
      },
      "dlco_lt_40": {
       "type": "boolean",
       "description": "DLCO <40% predicted as assigned by the caller (Benza 2019 REVEAL 2.
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reveal-2-0-pah-12-month-mortality-risk-calculator-0e4a3e52/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)