# HEAVEN Criteria Calculator (Davis 2017)

> HEAVEN Criteria Calculator (Davis 2017) 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 Davis 2017 HEAVEN score for rapid-sequence intubation risk from six caller-assigned boolean flags, returning high_risk status and criteria count

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/heaven
- 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/heaven-criteria-calculator-davis-2017-9f32622f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2QNWH6BP0lj0lssbXH_H3

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 heaven-criteria-calculator-davis-2017-9f32622f
```

Example prompt: Calculate the HEAVEN score for a patient who has hypoxemia and limited neck mobility but no extremes of size, no anatomic challenges, no vomit or blood, and no exsanguination — tell me how many criteria are met and whether they're high risk.

## When to prefer this

Use this endpoint when you need a fast, stateless computation of the Davis 2017 HEAVEN score from six pre-assessed boolean flags — ideal when a clinical agent or workflow has already gathered airway assessment inputs and needs the composite risk classification. Prefer over manual scoring when integrating HEAVEN into automated clinical decision-support pipelines. Not a substitute for Mallampati scoring (anatomic grading) or EGRI (a different difficult-airway score).

## Known failure modes

- Missing any of the six required boolean query parameters returns a validation error
- Non-boolean values for flag parameters cause a schema error
- Payment failure (x402 protocol) prevents call from completing
- All flags false returns low_risk=true and criteria_met=0, which is a valid result not an error

## How this service works

Davis 2017 HEAVEN criteria from six caller-assigned flags: hypoxemia (SpO2 ≤93% at initial laryngoscopy as assigned), extremes of size (pediatric ≤8 years or clinical obesity as assigned), anatomic challenges, vomit/blood/fluid, exsanguination, and limited neck mobility. high_risk iff any is true; criteria_met is the count of true flags (0-6); low_risk iff none. Not an intubation order. magent does not measure SpO2 or examine the airway. Not Mallampati, not EGRI.

## Output

Returns a structured result with: high_risk (boolean, true if any of the six HEAVEN flags is true), low_risk (boolean, true only if all flags are false), and criteria_met (integer 0–6 counting how many flags were true). Does not include intubation recommendations or clinical guidance.

## 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": [
      "hypoxemia",
      "extremes_of_size",
      "anatomic_challenges",
      "vomit_blood_fluid",
      "exsanguination",
      "neck_mobility_limited"
     ],
     "properties": {
      "hypoxemia": {
       "type": "boolean",
       "description": "Hypoxemia (SpO2 ≤93% at initial laryngoscopy) as assigned by the caller (Davis 2017). true is a HEAVEN flag. magent does not measure SpO2."
      },
      "exsanguination": {
       "type": "boolean",
       "description": "Exsanguination (suspected anemia that would accelerate desaturation) as assigned by the caller (Davis 2017). true is a HEAVEN flag. magent does not assay hemoglobin."
      },
      "extremes_of_size": {
       "type": "boolean",
       "description": "Extremes of size (pediatric ≤8 years or clinical obesity) as assigned by the caller (Davis 2017). true is a HEAVEN flag. magent does not examine the patient or assign age."
      },
      "vomit_blood_fluid": {
       "type": "boolean",
       "description": "Vomit, blood, or fluid in the pharynx or hypopharynx as assigned by the caller (Davis 2017). true is a HEAVEN flag. magent does not examine the airway."
      },
      "anatomic_challenges": {
       "type": "boolean",
       "description": "Anatomic challenges that limit laryngoscopy as assigned by the caller (Davis 2017). true is a HEAVEN flag. magent does not examine the airway."
      },
      "neck_mobility_limited": {
       "type": "boolean",
       "description": "Limited neck mobility as assigned by the caller (Davis 2017). true is a HEAVEN flag. magent does not examine the neck."
      }
     }
    }
   },
   "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/heaven-criteria-calculator-davis-2017-9f32622f/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)