{"uid":"cap_2QNWH6BP0lj0lssbXH_H3","slug":"heaven-criteria-calculator-davis-2017-9f32622f","name":"HEAVEN Criteria Calculator (Davis 2017)","description":"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.","url":"https://api.magentlab.com/api/calc/heaven","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5D3ITCHq6yio0z5n31uTr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Davis 2017 HEAVEN score for rapid-sequence intubation risk from six caller-assigned boolean flags, returning high_risk status and criteria count","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-intubation RSI triage in the ED","prompt":"Before we intubate this trauma patient, run the HEAVEN score — they have suspected exsanguination and there's blood in the airway, but no hypoxemia yet, no size extremes, no anatomic challenges, and normal neck mobility. How many criteria are met and are they high risk?"},{"title":"Pediatric airway risk check","prompt":"I'm about to intubate a 6-year-old. Flag extremes of size as true since they're under 8, hypoxemia true because SpO2 was 91%, and all other HEAVEN flags false. What's their HEAVEN score and risk level?"},{"title":"Obese patient with limited neck mobility","prompt":"Score the HEAVEN criteria for an obese adult patient with limited neck mobility and anatomic challenges — hypoxemia is false, no vomit or blood, no exsanguination. Give me the count of criteria met and whether that's high risk."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:46.194Z","isFirstParty":false}