{"uid":"cap_o5BhJFUKoK9oGg4AObOk3","slug":"years-algorithm-pe-exclusion-calculator-42ade27c","name":"YEARS Algorithm PE Exclusion Calculator","description":"YEARS algorithm (van der Hulle 2017 Lancet). Count three caller-assigned items (clinical signs of DVT, hemoptysis, PE most likely) and exclude PE only when D-dimer (ng/mL FEU) is strictly below 1000 with 0 items or 500 with 1-3 items. Equality is not excluded. Not a diagnosis, not Wells, not PERC. magent does not decide PE most likely. The 2017 cohort excluded pregnancy.","url":"https://api.magentlab.com/api/calc/years?utm_source=zero.xyz","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":["clinical_signs_dvt","hemoptysis","pe_most_likely","d_dimer_ng_ml"],"properties":{"hemoptysis":{"type":"boolean","description":"Hemoptysis. true or false as assigned by the caller. Counts as one unweighted YEARS item when true."},"d_dimer_ng_ml":{"type":"number","description":"D-dimer in ng/mL fibrinogen-equivalent units (FEU) as in van der Hulle 2017 (0-20000). PE excluded only when strictly below 1000 (0 YEARS items) or 500 (1-3 items). Equality is not excluded."},"pe_most_likely":{"type":"boolean","description":"PE is the most likely diagnosis, as assigned by the caller. magent does not decide PE most likely. Counts as one unweighted YEARS item when true."},"clinical_signs_dvt":{"type":"boolean","description":"Clinical signs of deep-vein thrombosis. true or false as assigned by the caller. Counts as one unweighted YEARS item when true."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"path":"/api/calc/years","count":2,"items":[{"formula":"years","citation":{"id":"van-der-hulle-2017","doi":"10.1016/S0140-6736(17)30885-1","title":"Simplified diagnostic management of suspected pulmonary embolism (the YEARS study): a prospective, multicentre, cohort study","source":"Lancet. 2017;390(10091):289-297","authors":"van der Hulle T, Cheung WY, Kooij S, et al."},"criteria":[{"met":false,"factor":"clinical_signs_dvt"},{"met":false,"factor":"hemoptysis"},{"met":false,"factor":"pe_most_likely"}],"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.","pe_excluded":true,"years_items":0,"d_dimer_ng_ml":499,"ctpa_indicated":false,"formula_expression":"PE excluded iff (years_items == 0 and d_dimer_ng_ml < 1000) or (years_items >= 1 and d_dimer_ng_ml < 500); years_items counts clinical_signs_dvt, hemoptysis, and pe_most_likely","d_dimer_threshold_ng_ml":1000},{"formula":"years","citation":{"id":"van-der-hulle-2017","doi":"10.1016/S0140-6736(17)30885-1","title":"Simplified diagnostic management of suspected pulmonary embolism (the YEARS study): a prospective, multicentre, cohort study","source":"Lancet. 2017;390(10091):289-297","authors":"van der Hulle T, Cheung WY, Kooij S, et al."},"criteria":[{"met":false,"factor":"clinical_signs_dvt"},{"met":false,"factor":"hemoptysis"},{"met":false,"factor":"pe_most_likely"}],"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.","pe_excluded":true,"years_items":0,"d_dimer_ng_ml":499,"ctpa_indicated":false,"formula_expression":"PE excluded iff (years_items == 0 and d_dimer_ng_ml < 1000) or (years_items >= 1 and d_dimer_ng_ml < 500); years_items counts clinical_signs_dvt, hemoptysis, and pe_most_likely","d_dimer_threshold_ng_ml":1000}]}},"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_zJlOlDpETgvj1B-GUlvft","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":"Applies the YEARS algorithm (van der Hulle 2017) to determine whether pulmonary embolism can be excluded based on three clinical items and D-dimer threshold","exampleAgentPrompt":"Using the YEARS algorithm, can you check if PE can be excluded for a patient with no clinical signs of DVT, no hemoptysis, PE is not the most likely diagnosis, and a D-dimer of 450 ng/mL FEU?","exampleUseCases":[{"title":"Emergency department PE rule-out","prompt":"I have a patient in the ED — no clinical signs of DVT, no hemoptysis, and PE is not the most likely diagnosis. Their D-dimer came back at 480 ng/mL FEU. Can you run the YEARS algorithm and tell me if PE can be excluded?"},{"title":"Positive YEARS item with borderline D-dimer","prompt":"My patient has hemoptysis and clinical signs of DVT, but PE is not the most likely diagnosis. D-dimer is 520 ng/mL FEU. Apply the YEARS criteria — can PE be ruled out?"},{"title":"All YEARS items positive, elevated D-dimer","prompt":"Patient has all three YEARS items positive: DVT signs, hemoptysis, and PE is the most likely diagnosis. D-dimer is 1200 ng/mL FEU. Run the YEARS algorithm and tell me the result."}],"resultDescription":"Returns the computed YEARS item count (0–3), the applicable D-dimer threshold (1000 ng/mL for 0 items, 500 ng/mL for 1–3 items), and whether PE can be excluded based on whether the D-dimer is strictly below that threshold (equality is not excluded). Includes interpretive context per the van der Hulle 2017 Lancet cohort criteria.","failureModes":["Missing required query parameters (clinical_signs_dvt, hemoptysis, pe_most_likely, d_dimer_ng_ml) returns a validation error","D-dimer value outside 0–20000 ng/mL range may return an error or out-of-range warning","Payment failure or missing x402 payment header returns 402 Payment Required","Boolean parameters passed as strings instead of true/false may cause parsing errors","Pregnancy patients: the 2017 cohort excluded pregnancy, so results may not apply"],"whenToPreferThis":"Use this endpoint when you need a standardized, evidence-based computation of the YEARS algorithm (van der Hulle 2017 Lancet) for PE exclusion decisions. Prefer this over general clinical calculators when you specifically need the YEARS criteria (not Wells score, not PERC rule) with precise D-dimer threshold application. Useful in automated clinical decision support workflows where the caller has already assessed the three YEARS items and has a numeric D-dimer value in ng/mL FEU.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:47:53.955Z","isFirstParty":false,"canonicalSlug":"years-algorithm-pe-exclusion-calculator-42ade27c"}