# Barbour 2019 IgAN 5-Year Risk Model (Race-Free)

> Barbour 2019 IgAN 5-Year Risk Model (Race-Free) 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).

Calculates the 5-year risk of 50% eGFR decline or ESKD in IgA nephropathy patients using the Barbour 2019 race-free Cox model with age, eGFR, MAP, proteinuria, Oxford MEST scores, and treatment variables.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/igan_predict
- 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/barbour-2019-igan-5-year-risk-model-race-free-26e2391c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QjAoZe00odhL3NqRvz6Ke

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 barbour-2019-igan-5-year-risk-model-race-free-26e2391c
```

Example prompt: Run the Barbour 2019 race-free IgAN 5-year risk model for a 42-year-old patient with eGFR 55, MAP 102 mmHg, proteinuria 1.8 g/day, Oxford MEST scores M1, E0, S1, T1, on RAS blockade but no immunosuppression at biopsy.

## When to prefer this

Use this endpoint when you need the Barbour 2019 race-free Cox model specifically for IgA nephropathy prognosis and have pre-scored Oxford MEST pathology values and a caller-supplied eGFR. Prefer this over KFRE (which is not IgAN-specific and does not use MEST scores) or the Barbour race/ethnicity model variant. Do not use for CKD of other etiologies, diagnosis, or treatment planning.

## Known failure modes

- Missing required query parameters (age, eGFR, MAP, proteinuria, all four MEST scores, rasb_at_biopsy, immunosuppression_at_biopsy) return a validation error
- Out-of-range values (e.g., age < 18, proteinuria > 20, MAP outside 30–180) may trigger rejection or undefined behavior
- mest_t values other than 0, 1, or 2 are invalid and will be rejected
- mest_m/e/s values other than 0 or 1 are invalid
- Boolean fields rasb_at_biopsy or immunosuppression_at_biopsy sent as strings instead of true/false may fail parsing
- Network or payment (x402) errors may prevent the call from completing

## How this service works

Barbour 2019 race-free full IgAN model: 5-year risk of 50% eGFR decline or ESKD from age, eGFR, MAP, proteinuria g/day, Oxford MEST, RAS blockade, and immunosuppression at biopsy. Risk = 1 - S0(60)^exp(LP) with eTable 3 coefficients. Caller supplies eGFR; magent does not compute CKD-EPI or score the biopsy. Not the race/ethnicity model. Not KFRE. Not a diagnosis or treatment order. Not a medical device.

## Output

Returns the computed 5-year risk (probability) of 50% eGFR decline or end-stage kidney disease, derived from the Barbour 2019 race-free Cox proportional hazards model. Output includes the linear predictor (LP) and the final risk estimate: 1 − S0(60)^exp(LP), using the published eTable 3 coefficients. Does not return a diagnosis, treatment recommendation, or biopsy scoring.

## 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": [
      "age_years",
      "egfr_ml_min_1_73m2",
      "map_mm_hg",
      "proteinuria_g_day",
      "mest_m",
      "mest_e",
      "mest_s",
      "mest_t",
      "rasb_at_biopsy",
      "immunosuppression_at_biopsy"
     ],
     "properties": {
      "mest_e": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "Oxford MEST endocapillary hypercellularity at biopsy. 0 = E0, 1 = E1. magent does not score the biopsy."
      },
      "mest_m": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "Oxford MEST mesangial hypercellularity at biopsy. 0 = M0, 1 = M1. magent does not score the biopsy."
      },
      "mest_s": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "Oxford MEST segmental sclerosis at biopsy. 0 = S0, 1 = S1. magent does not score the biopsy."
      },
      "mest_t": {
       "enum": [
        0,
        1,
        2
       ],
       "type": "integer",
       "description": "Oxford MEST tubular atrophy/interstitial fibrosis at biopsy. 0 = T0, 1 = T1, 2 = T2. T1 and T2 have main-effect and proteinuria-interaction terms. magent does not score the biopsy."
      },
      "age_years": {
       "type": "integer",
       "description": "Age at biopsy in years (integer 18-120). Barbour 2019 derivation was adults 18 years or older. Enters the linear predictor as age_years - 38."
      },
      "map_mm_hg": {
       "type": "number",
       "description": "Mean arterial pressure at biopsy in mm Hg (30-180). Enters centered at 97 and in the proteinuria×MAP interaction."
      },
      "rasb_at_biopsy": {
       "type": "boolean",
       "description": "true if renin-angiotensin system blockade (ACE inhibitor or ARB) was in use at biopsy. Enters as 1 or 0 plus a RASB×proteinuria term. magent does not prescribe RAS blockade."
      },
      "proteinuri
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/barbour-2019-igan-5-year-risk-model-race-free-26e2391c/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)
