# IMPROVE VTE Score Calculator (Spyropoulos 2011)

> IMPROVE VTE Score Calculator (Spyropoulos 2011) 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).

Calculates the 7-factor IMPROVE VTE risk score for hospitalized medical patients based on caller-assigned clinical flags and patient age.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/improve_vte
- 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/improve-vte-score-calculator-spyropoulos-2011-04f2d2fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x4FcAMopN1-cXyZ4iU7sW

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 improve-vte-score-calculator-spyropoulos-2011-04f2d2fb
```

Example prompt: Calculate the IMPROVE VTE score for a 68-year-old hospitalized patient who has a previous VTE, is currently in the ICU, and has been immobilized for 9 days — no cancer, no thrombophilia, no lower-limb paralysis.

## When to prefer this

Use this endpoint when you need to compute the validated Spyropoulos 2011 7-factor IMPROVE VTE score specifically — not the 4-factor admission predictive model, not IMPROVEDD, and not other VTE scoring systems (e.g. Caprini, Padua, DASH). Prefer this for hospitalized medical patients where clinical flags have already been assessed by a clinician and need to be converted into a standardized numeric score and risk band.

## Known failure modes

- Missing required query parameter returns validation error
- Age outside 18–120 range may be rejected or return unexpected results
- Boolean parameters passed as strings instead of true/false may fail
- Caller-assigned clinical flags that are clinically inaccurate will produce a score reflecting those inputs, not the true clinical state

## How this service works

Spyropoulos 2011 7-factor associative IMPROVE VTE score during hospitalization: previous VTE 3, known thrombophilia 2, lower-limb paralysis 2, current cancer 2, immobilized >=7 days 1, ICU/CCU stay 1, age >60 1. Max 12. Bands: 0-1; 2-3 (observed VTE 1.5%); >=4 (observed VTE 5.7%). Not a VTE diagnosis or prophylaxis order. Not the 4-factor admission predictive model. Not IMPROVEDD. magent does not examine the patient.

## Output

Returns the numeric IMPROVE VTE score (0–12), the corresponding risk band (0–1, 2–3, or ≥4), and the observed VTE rate associated with that band (1.5% for band 2–3, 5.7% for band ≥4). Does not provide prophylaxis orders or VTE diagnoses.

## 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",
      "previous_vte",
      "known_thrombophilia",
      "lower_limb_paralysis",
      "current_cancer",
      "immobilized_ge_7_days",
      "icu_ccu_stay"
     ],
     "properties": {
      "age": {
       "type": "integer",
       "description": "Age in years (18-120). Scores 1 when age >60 (Spyropoulos 2011). Age 60 scores 0; age 61 scores 1."
      },
      "icu_ccu_stay": {
       "type": "boolean",
       "description": "ICU or CCU stay as assigned by the caller (Spyropoulos 2011, during hospitalization). true or false. 1 point if true. magent does not assign level of care."
      },
      "previous_vte": {
       "type": "boolean",
       "description": "Previous VTE as assigned by the caller (Spyropoulos 2011 7-factor associative model). true or false. 3 points if true. magent does not diagnose VTE."
      },
      "current_cancer": {
       "type": "boolean",
       "description": "Current cancer as assigned by the caller (Spyropoulos 2011). true or false. 2 points if true. magent does not diagnose cancer."
      },
      "known_thrombophilia": {
       "type": "boolean",
       "description": "Known thrombophilia as assigned by the caller (Spyropoulos 2011). true or false. 2 points if true. magent does not interpret a thrombophilia panel."
      },
      "lower_limb_paralysis": {
       "type": "boolean",
       "description": "Lower-limb paralysis as assigned by the caller (Spyropoulos 2011). true or false. 2 points if true. magent does not examine the patient."
      },
      "immobilized_ge_7_days": {
       "type": "boolean",
       "description": "Immobilized ≥7 days as assigned by the caller (Spyropoulos 2011, during hospitalization). true or false. 1 point if true. magent does not observe mobility."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/improve-vte-score-calculator-spyropoulos-2011-04f2d2fb/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)