# Karter 2017 12-Month Hypoglycemia Risk Score (T2D)

> Karter 2017 12-Month Hypoglycemia Risk Score (T2D) 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).

Classifies a type 2 diabetes patient into high, intermediate, or low 12-month risk of hypoglycemia-related ED or hospital use based on the Karter 2017 Figure 2 decision tree.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/hypoglycemia_risk_score
- 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/karter-2017-12-month-hypoglycemia-risk-score-t2d-45110e7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8klvtgZDMyGx1zUt-Lb7X

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 karter-2017-12-month-hypoglycemia-risk-score-t2d-45110e7b
```

Example prompt: Using the Karter 2017 hypoglycemia risk algorithm, classify this T2D patient: they've had 2 prior hypoglycemia-related ED or hospital episodes, 3 ED visits in the past 12 months for any reason, they're on insulin but not sulfonylurea, no severe kidney disease, and they're 70 years old (so age under 77 is true).

## When to prefer this

Use this endpoint when you need to apply the specific Karter 2017 Figure 2 branching algorithm for 12-month hypoglycemia-related ED or hospitalization risk in type 2 diabetes patients. Prefer it over generic risk calculators when the clinical context explicitly calls for the Karter 2017 evidence-based rule, especially in care management workflows that need programmatic stratification without building the decision logic themselves.

## Known failure modes

- Missing required query parameters returns a validation error
- Out-of-range integer values (e.g. prior_hypo_ed_hospital_count > 20 or ed_visits_12mo > 50) may return an error or undefined behavior
- Non-boolean values for insulin, sulfonylurea, severe_or_esrd, or age_lt_77 cause schema validation failure
- Payment failure or missing x402 header results in 402 Payment Required response

## How this service works

Karter 2017 Figure 2 T2D 12-month hypoglycemia-related ED/hospital-use risk from prior_hypo_ed_hospital_count (0-20), ed_visits_12mo (0-50), insulin, sulfonylurea, severe_or_esrd (dialysis or CKD 4-5, eGFR <=29), and age_lt_77. First-match 6 options: >=3 prior or 1-2 plus insulin = high (>5%); remaining rows intermediate (1-5%) or low (<1%). Not a points sum. magent does not assay glucose. Not a diagnosis. Not an insulin dose.

## Output

Returns one of three risk categories — high (>5% 12-month probability of hypoglycemia-related ED or hospital use), intermediate (1–5%), or low (<1%) — determined by first-match traversal of the Karter 2017 Figure 2 decision tree. Not a points sum; not a glucose measurement; not a clinical diagnosis or prescription.

## 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": [
      "prior_hypo_ed_hospital_count",
      "ed_visits_12mo",
      "insulin",
      "sulfonylurea",
      "severe_or_esrd",
      "age_lt_77"
     ],
     "properties": {
      "insulin": {
       "type": "boolean",
       "description": "Current insulin use as assigned by the caller (Karter 2017 Figure 2). true or false. With 1-2 prior hypoglycemia-related ED or hospital episodes, insulin is high; with 0 prior episodes, insulin plus ED visits >=2, severe_or_esrd, or age not <77 is intermediate. Not an insulin dose."
      },
      "age_lt_77": {
       "type": "boolean",
       "description": "Age younger than 77 years as assigned by the caller (Karter 2017 Figure 2). true or false. When prior episodes are 0 and insulin is true, age not <77 (with ED visits <2 and severe_or_esrd false) is intermediate. magent does not compute age."
      },
      "sulfonylurea": {
       "type": "boolean",
       "description": "Current sulfonylurea use as assigned by the caller (Karter 2017 Figure 2). true or false. With 0 prior episodes and no insulin, sulfonylurea plus ED visits >=2 or severe_or_esrd is intermediate. magent does not dispense medication."
      },
      "ed_visits_12mo": {
       "type": "integer",
       "description": "ED encounters for any reason in the prior 12 months (integer 0-50). Karter 2017 Figure 2 bands: <2 vs >=2. magent does not count visits."
      },
      "severe_or_esrd": {
       "type": "boolean",
       "description": "Severe or end-stage kidney disease as assigned by the caller (Karter 2017: dialysis or CKD stage 4-5, eGFR <=29 mL/min/1.73 m2). true or false. magent does not compute eGFR."
      },
      "prior_hypo_ed_hospital_count": {
       "type": "integer",
       "description": "Count of prior hypoglycemia-related ED visits or hospitalizations (integer 0-20). Karter 2017 Figure 2 bands: 0, 1-2, or >=3. >=3 is high regardless of other inputs. magent does not read 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/karter-2017-12-month-hypoglycemia-risk-score-t2d-45110e7b/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)