# Bateman 2015 RSE (Risk Score for Exacerbations) Calculator

> Bateman 2015 RSE (Risk Score for Exacerbations) 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 Bateman 2015 Risk Score for Exacerbations (RSE) using Table II normalized points from BMI, ACQ-5, FEV1 % predicted, daily rescue occasions, and GINA step, returning a 0–100 integer score.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/rse
- 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/bateman-2015-rse-risk-score-for-exacerbations-calculator-902dfa57
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zrpfunr1VUNCbcUM-qTRG

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 bateman-2015-rse-risk-score-for-exacerbations-calculator-902dfa57
```

Example prompt: My asthma patient is on GINA step 4, has an ACQ-5 of 2.8, FEV1 at 76% predicted, uses their rescue inhaler about 3 times a day, and has a BMI of 32 — can you calculate their Bateman 2015 RSE exacerbation risk score?

## When to prefer this

Use this endpoint when you need an objective, validated 0–100 numerical risk score for asthma exacerbations derived from the Bateman 2015 publication, specifically for patients on GINA steps 3 or 4. It is appropriate for automating clinical risk stratification pipelines where ACQ-5, spirometry, and other inputs have already been gathered and need to be scored per the published Table II algorithm. Prefer this over generic asthma severity tools when the Bateman 2015 derivation methodology is required for research, quality metrics, or decision support.

## Known failure modes

- Invalid GINA step (anything other than 3 or 4) returns an invalid_gina_step error
- FEV1 % predicted outside the valid range (10–150) is rejected
- rescue_occasions_per_day outside 0–30 is rejected
- Missing any required query parameter returns a 400-level error
- ACQ-5 outside 0–6 range may be rejected or produce unexpected scoring

## How this service works

Bateman 2015 Risk Score for Exacerbations (RSE): Table II normalized points from BMI >=30 (14), ACQ-5 (<1.5=0; 1.5 to <2.5=7; >=2.5=13), FEV1 % predicted (>=90=0; 80 to <90=13; <80=20), daily rescue occasions (<2=0; 2 to <4=11; >=4=26), and GINA step (3=0; 4=27). Total 0-100. Caller-assigned; magent does not administer ACQ-5 or spirometry. Not a diagnosis, GINA step change, or inhaler order.

## Output

Returns an integer RSE total (0–100) assembled from Table II normalized points across five domains: BMI flag (0 or 14), ACQ-5 band (0, 7, or 13), FEV1 % predicted band (0, 13, or 20), daily rescue occasions band (0, 11, or 26), and GINA step (0 or 27). Higher scores indicate greater exacerbation risk. The endpoint does not administer questionnaires, perform spirometry, issue diagnoses, change GINA steps, or order medications.

## 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": [
      "bmi_ge_30",
      "acq5",
      "fev1_percent_predicted",
      "rescue_occasions_per_day",
      "gina_step"
     ],
     "properties": {
      "acq5": {
       "type": "number",
       "description": "Caller-assigned 5-item Asthma Control Questionnaire mean (0-6). Table II: <1.5 scores 0; 1.5 <= ACQ-5 < 2.5 scores 7; >=2.5 scores 13. magent does not administer ACQ-5."
      },
      "bmi_ge_30": {
       "type": "boolean",
       "description": "Caller-assigned BMI >= 30 kg/m2 (Bateman 2015 Table II). true scores 14; false scores 0. magent does not compute BMI."
      },
      "gina_step": {
       "type": "integer",
       "description": "Caller-assigned GINA treatment step in the Bateman 2015 derivation population. Must be 3 (0 points) or 4 (27 points). Other steps are invalid_gina_step. Not a step-change or inhaler order."
      },
      "fev1_percent_predicted": {
       "type": "number",
       "description": "Caller-assigned FEV1 as percent of predicted (10-150). Table II: >=90 scores 0; 80 <= FEV1 < 90 scores 13; <80 scores 20. magent does not perform spirometry."
      },
      "rescue_occasions_per_day": {
       "type": "number",
       "description": "Caller-assigned daily reliever occasions (0-30). Table II: <2 scores 0; 2 <= occasions < 4 scores 11; >=4 scores 26. magent does not count inhaler actuations."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bateman-2015-rse-risk-score-for-exacerbations-calculator-902dfa57/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)