{"uid":"cap_Znaey0roBgluW17X6TZwe","slug":"4peps-pulmonary-embolism-probability-score-calculator-42eab251","name":"4PEPS Pulmonary Embolism Probability Score Calculator","description":"Roy 2021 4PEPS Table 3: age <50 −2, 50–64 −1, ≥65 0; chronic respiratory disease −1; HR <80 −1; chest pain and acute dyspnea +1; male +2; estrogen treatment +2; prior VTE +2; syncope +2; 4-week immobility +2; SpO2 <95% +3; calf pain or unilateral edema +3; PE most likely +5. Max 22. Bands: very_low <0, low 0–5, moderate 6–12, high ≥13. Not imaging or D-dimer. magent does not examine the patient or decide PE most likely.","url":"https://api.magentlab.com/api/calc/4peps","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":["age","chronic_respiratory_disease","heart_rate_bpm","chest_pain_and_acute_dyspnea","sex","hormonal_estrogenic_treatment","personal_history_vte","syncope","immobility_4w","spo2_percent","calf_pain_or_unilateral_edema","pe_most_likely"],"properties":{"age":{"type":"integer","description":"Age in years (integer 18-120). Roy 2021 Table 3: <50 scores −2; 50-64 scores −1; ≥65 scores 0 (65-80 and >80 were not independently associated)."},"sex":{"enum":["female","male"],"type":"string","description":"female or male (Roy 2021 Table 3). Male scores +2. Female scores 0. Assigned by the caller."},"syncope":{"type":"boolean","description":"Syncope as assigned by the caller (Roy 2021 Table 3). true scores +2. magent does not examine the patient."},"spo2_percent":{"type":"number","description":"Oxygen saturation percent (50-100). Roy 2021 Table 3: <95 scores +3; 95 and above score 0."},"immobility_4w":{"type":"boolean","description":"Immobility within 4 weeks (Roy 2021 Table 3 footnote a): surgery, lower limb plaster cast, or bedridden more than 3 days for an acute medical condition. true scores +2. Assigned by the caller. magent does not examine the patient."},"heart_rate_bpm":{"type":"integer","description":"Heart rate in beats per minute (integer 30-220). Table 3: <80 scores −1. 80-100 was not independently associated; this tool does not add tachycardia points."},"pe_most_likely":{"type":"boolean","description":"PE is the most likely diagnosis as assigned by the caller (Roy 2021 Table 3). true scores +5. magent does not examine the patient or decide PE most likely."},"personal_history_vte":{"type":"boolean","description":"Personal history of VTE as assigned by the caller (Roy 2021 Table 3). true scores +2."},"chronic_respiratory_disease":{"type":"boolean","description":"Chronic respiratory disease (Roy 2021 Table 3). true scores −1. Assigned by the caller. magent does not examine the patient."},"chest_pain_and_acute_dyspnea":{"type":"boolean","description":"Both chest pain and acute dyspnea present as assigned by the caller (Roy 2021 Table 3). true scores +1. magent does not examine the patient."},"calf_pain_or_unilateral_edema":{"type":"boolean","description":"Calf pain and/or unilateral lower-limb edema as assigned by the caller (Roy 2021 Table 3). true scores +3. magent does not examine the patient."},"hormonal_estrogenic_treatment":{"type":"boolean","description":"Hormonal estrogenic treatment as assigned by the caller (Roy 2021 Table 3). true scores +2."}}}},"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_AYdybXtPnfzQg2BGDYouT","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 Roy 2021 4PEPS clinical decision score for pulmonary embolism pre-test probability, returning a numeric score and risk band (very_low, low, moderate, or high).","exampleAgentPrompt":"Calculate the 4PEPS score for a 62-year-old male patient: no chronic respiratory disease, heart rate 92 bpm, presenting with chest pain and acute dyspnea, on hormonal estrogen therapy, prior VTE history, no syncope, no 4-week immobility, SpO2 at 93%, calf pain present, and PE is the most likely diagnosis.","exampleUseCases":[{"title":"ED triage for suspected PE","prompt":"I have a 48-year-old female in the ED with acute dyspnea and SpO2 of 91%, heart rate 105 bpm, no chronic respiratory disease, no hormonal treatment, no prior VTE, no syncope, no recent immobility, no calf pain or edema, and PE is not yet deemed most likely — what does her 4PEPS score come out to?"},{"title":"Pre-imaging PE risk stratification","prompt":"Before I order a CT pulmonary angiogram, calculate the 4PEPS score for this 67-year-old male patient: chronic respiratory disease present, heart rate 78 bpm, no chest pain or acute dyspnea, no estrogen therapy, prior VTE, syncope occurred, he was bedridden for 5 days last month, SpO2 is 97%, no calf pain, and PE is the most likely diagnosis."},{"title":"Low-risk PE rule-out workflow","prompt":"Can you run the Roy 2021 4PEPS calculation for a 44-year-old female: no chronic respiratory disease, heart rate 82 bpm, chest pain and dyspnea present, no estrogen treatment, no prior VTE, no syncope, no immobility, SpO2 96%, unilateral leg edema present, and PE is not the most likely diagnosis — I want to see if she falls in the very low or low band to consider skipping imaging."}],"resultDescription":"Returns the calculated 4PEPS integer score (max 22) and a categorical risk band: very_low (score <0), low (0–5), moderate (6–12), or high (≥13). Does not provide imaging recommendations or D-dimer guidance, and does not make clinical decisions independently.","failureModes":["Missing required query parameters (e.g. age, sex, spo2_percent) return a validation error","Out-of-range values (e.g. age <18, SpO2 outside 50–100, heart rate outside 30–220) are rejected","pe_most_likely must be assigned by caller — endpoint does not infer clinical likelihood","Boolean fields passed as non-boolean strings may cause parsing errors","Score interpretation is limited to the four defined bands; caller must apply clinical context"],"whenToPreferThis":"Use this endpoint when you need a validated, rule-based computation of the Roy 2021 4PEPS pre-test probability score for pulmonary embolism, particularly in agentic clinical decision support workflows where reproducibility and audit-ability matter. Prefer this over general LLM-based clinical reasoning when you need a deterministic, scored output tied directly to published coefficients. This endpoint does not replace imaging decisions or D-dimer thresholds — it computes the structured score only.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:10:36.327Z","isFirstParty":false}