# IPI (International Prognostic Index) Calculator — Shipp 1993

> IPI (International Prognostic Index) Calculator — Shipp 1993 is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Computes the Shipp 1993 International Prognostic Index (IPI) score and risk group for aggressive non-Hodgkin lymphoma from five caller-supplied clinical flags.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/ipi?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ipi-international-prognostic-index-calculator-shipp-1993-9b617356
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q86X3sFfoFVJKABaQQSos

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 ipi-international-prognostic-index-calculator-shipp-1993-9b617356
```

Example prompt: Calculate the Shipp 1993 IPI score for a 67-year-old patient with Ann Arbor stage IV disease, more than one extranodal site, ECOG performance status 2, and LDH above the upper limit of normal.

## When to prefer this

Use this endpoint when you need a deterministic, citeable Shipp 1993 IPI computation from structured clinical flags. Prefer it over manual calculation when building oncology decision-support agents, clinical trial enrollment tools, or EHR enrichment pipelines. Do not use it for age-adjusted IPI (AA-IPI), revised IPI (R-IPI), or NCCN-IPI variants — those are distinct instruments. This endpoint does not perform LDH assay, ECOG assessment, or lymphoma staging; all five flags must be pre-determined by the clinical caller.

## Known failure modes

- Missing required query parameters (age, stage_iii_or_iv, extranodal_gt_1, ecog, ldh_gt_uln) returns a 400 error
- Age outside the 18–120 integer range may be rejected or produce unexpected results
- ECOG values outside 0–4 may cause validation errors
- Payment not provided or invalid x402 payment results in 402 Payment Required
- Network timeout or service unavailability returns a 5xx error

## How this service works

Deterministic published-formula arithmetic plus ICD-10-CM, RxNorm, and LOINC. Pay in USDC on Base via x402.

## Output

Returns the computed IPI total score (integer 0–5) and the corresponding risk group label: low (0–1 points), low_intermediate (2 points), high_intermediate (3 points), or high (4–5 points), based on the Shipp 1993 publication.

## 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",
      "stage_iii_or_iv",
      "extranodal_gt_1",
      "ecog",
      "ldh_gt_uln"
     ],
     "properties": {
      "age": {
       "type": "integer",
       "description": "Age in years (18-120). Age >60 scores 1 (Shipp 1993). Age 60 is the ≤60 arm and scores 0."
      },
      "ecog": {
       "type": "integer",
       "description": "ECOG performance status 0-4 as assigned by the caller (Shipp 1993). ≥2 scores 1. magent does not assign ECOG."
      },
      "ldh_gt_uln": {
       "type": "boolean",
       "description": "Serum LDH above the upper limit of normal as assigned by the caller (Shipp 1993). true scores 1. magent does not assay LDH."
      },
      "extranodal_gt_1": {
       "type": "boolean",
       "description": "More than one extranodal site as assigned by the caller (Shipp 1993). true scores 1. magent does not count extranodal sites."
      },
      "stage_iii_or_iv": {
       "type": "boolean",
       "description": "Ann Arbor stage III or IV as assigned by the caller (Shipp 1993). true scores 1. magent does not stage lymphoma."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "path": "/api/calc/ipi",
  "count": 2,
  "items": [
   {
    "ecog": 0,
    "score": 0,
    "formula": "ipi",
    "citation": {
     "id": "shipp-1993",
     "doi": "10.1056/NEJM199309303291402",
     "pmid": "8141877",
     "title": "A predictive model for aggressive non-Hodgkin's lymphoma",
     "source": "N Engl J Med. 1993;329(14):987-994",
     "authors": "The International Non-Hodgkin's Lymphoma Prognostic Factors Project"
    },
    "ipi_risk": "low",
    "age_years": 50,
    "max_score": 5,
    "components": [
     {
      "value": 50,
      "factor": "age_gt_60",
      "points": 0,
      "present": false
     },
     {
      "factor": "stage_iii_or_iv",
      "points": 0,
      "present": false
     },
     {
      "factor": "extranodal_gt_1",
      "points": 0,
      "present": false
     },
     {
      "value": 0,
      "factor": "ecog_ge_2",
      "points": 0,
      "present": false
     },
     {
      "factor": "ldh_gt_uln",
      "points": 0,
      "present": false
     }
    ],
    "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
    "formula_expression": "IPI = age_gt_60 1 + stage_iii_or_iv 1 + extranodal_gt_1 1 + ecog_ge_2 1 + ldh_gt_uln 1; Shipp 1993; max 5; low 0-1, low_intermediate 2, high_intermediate 3, high 4-5"
   },
   {
    "ecog": 0,
    "score": 0,
    "formula": "ipi",
    "citation": {
     "id": "shipp-1993",
     "doi": "10.1056/NEJM199309303291402",
     "pmid": "8141877",
     "title": "A predictive model for aggressive non-Hodgkin's lymphoma",
     "source": "N Engl J Med. 1993;329(14):987-994",
     "authors": "The International Non-Hodgkin's Lymphoma Prognostic Factors Project"
    },
    "ipi_risk": "low",
    "age_years": 50,
    "max_score": 5,
    "components": [
     {
      "value": 50,
      "factor": "age_gt_60",
      "points": 0,
      "present": false
     },
     {
      "factor": "stage_iii_or_iv",
      "points": 0,
      "present": false
     },
     {
      "factor": "extranodal_gt_1",
      "points": 0,
      "present": false
     },
     {
      "value": 0,
      "factor": "ecog_ge_2",
      "points": 0,
      "present": false
     },
     {
      "factor": "ldh_gt_uln",
      "points": 0,
      "present": false
     }
    ],
    "disclaimer": "Not a medical device. Deterministic published-formula or published-code 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ipi-international-prognostic-index-calculator-shipp-1993-9b617356/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)