{"uid":"cap_rz9b2rHyyymvqInHvOm6a","slug":"khan-2019-pcp-hf-10-year-incident-heart-failure-risk-calculator-9a89b7ce","name":"Khan 2019 PCP-HF 10-Year Incident Heart Failure Risk Calculator","description":"Khan 2019 PCP-HF 10-year incident heart-failure percent for age 30-79 from sex, caller-assigned white or black cohort, treated or untreated systolic BP and fasting glucose, total and HDL cholesterol, BMI, smoking, and QRS duration. Table 2 coefficients. Caller assigns cohort; magent does not assign race. Not PREVENT 2024, not 2013 PCE, not a diagnosis or treatment order. magent does not assay lipids, measure blood pressure, or interpret an ECG.","url":"https://api.magentlab.com/api/calc/pcp_hf","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","sex","cohort","sbp_mm_hg","antihypertensive","glucose_mg_dl","diabetes_medication","bmi_kg_m2","total_cholesterol_mg_dl","hdl_mg_dl","smoker","qrs_ms"],"properties":{"age":{"type":"integer","description":"Age in years (integer 30-79). Khan 2019 Table 2 10-year incident HF is for ages 30-79. magent does not take a date of birth."},"sex":{"enum":["female","male"],"type":"string","description":"Sex used by the sex-specific Table 2 coefficients (female or male). Not cohort."},"cohort":{"enum":["white","black"],"type":"string","description":"Caller-assigned cohort as used in Khan 2019 Table 2: white or black (paper terms). Not param race. magent does not assign race or ethnicity. Other strings are rejected."},"qrs_ms":{"type":"number","description":"QRS duration in ms (40-300). Enters as ln(QRS). magent does not interpret an ECG."},"smoker":{"type":"boolean","description":"Current cigarette smoking as assigned by the caller (true or false). Adds the Table 2 smoker term and ln(age) × smoker when that cell is not N/A. magent does not take a smoking history."},"bmi_kg_m2":{"type":"number","description":"Body-mass index in kg/m2 (10-80). Enters as ln(BMI) and ln(age)×ln(BMI) when that Table 2 cell is not N/A. magent does not measure height or weight."},"hdl_mg_dl":{"type":"number","description":"HDL cholesterol in mg/dL (5-150). Enters as ln(HDL-C) when that Table 2 cell is not N/A. magent does not assay lipids."},"sbp_mm_hg":{"type":"number","description":"Systolic blood pressure in mm Hg (50-250). Enters as ln(SBP) with the treated or untreated Table 2 coefficient according to antihypertensive. magent does not measure blood pressure."},"glucose_mg_dl":{"type":"number","description":"Fasting glucose in mg/dL (40-600). Enters as ln(glucose) with the treated or untreated Table 2 coefficient according to diabetes_medication. magent does not assay glucose."},"antihypertensive":{"type":"boolean","description":"Current antihypertensive treatment as assigned by the caller (true or false). true uses the Table 2 treated-SBP coefficient (and age × treated SBP when that cell is not N/A). false uses untreated SBP. Not both."},"diabetes_medication":{"type":"boolean","description":"Current diabetes medication as assigned by the caller (true or false). true uses the Table 2 treated-glucose coefficient. false uses untreated glucose. Not both."},"total_cholesterol_mg_dl":{"type":"number","description":"Total cholesterol in mg/dL (50-800). Enters as ln(total cholesterol) when that Table 2 cell is not N/A. magent does not assay lipids."}}}},"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_dtpgBiegeaKKBUCATxa9z","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 10-year incident heart failure risk percent (ages 30-79) using Khan 2019 Table 2 PCP-HF coefficients, stratified by sex and caller-assigned white or black cohort.","exampleAgentPrompt":"Using the Khan 2019 PCP-HF model, calculate the 10-year heart failure risk for a 58-year-old male in the white cohort with a systolic BP of 148 mmHg (on antihypertensive medication), fasting glucose of 105 mg/dL (no diabetes medication), BMI of 29.4 kg/m2, total cholesterol 210 mg/dL, HDL 42 mg/dL, non-smoker, and QRS duration of 94 ms.","exampleUseCases":[{"title":"Primary care cardiovascular risk panel","prompt":"Run the Khan 2019 PCP-HF 10-year heart failure risk calculation for a 63-year-old female in the black cohort: systolic BP 155 mmHg treated with antihypertensives, fasting glucose 118 mg/dL with no diabetes medication, BMI 31.2, total cholesterol 195 mg/dL, HDL 50 mg/dL, current smoker, QRS duration 88 ms."},{"title":"Untreated hypertension risk assessment","prompt":"What is the 10-year incident heart failure percent for a 45-year-old male in the white cohort with untreated systolic BP of 162 mmHg, fasting glucose of 98 mg/dL and no diabetes medication, BMI 27.5, total cholesterol 220 mg/dL, HDL 38 mg/dL, non-smoker, and QRS of 102 ms?"},{"title":"Diabetes and elevated QRS risk stratification","prompt":"Calculate the Khan 2019 PCP-HF heart failure risk for a 70-year-old female in the black cohort: systolic BP 138 mmHg untreated, fasting glucose 145 mg/dL on diabetes medication, BMI 33.8, total cholesterol 178 mg/dL, HDL 44 mg/dL, non-smoker, QRS duration 120 ms."}],"resultDescription":"Returns the 10-year incident heart failure risk as a percentage, computed from Khan 2019 Table 2 PCP-HF coefficients using the supplied sex- and cohort-specific model terms including log-transformed age, SBP, glucose, BMI, cholesterol, HDL, QRS, and binary smoking and treatment flags.","failureModes":["Age outside 30-79 range is rejected","Cohort value other than 'white' or 'black' is rejected","SBP outside 50-250 mmHg range causes validation error","QRS outside 40-300 ms range causes validation error","Missing any required query parameter returns an error","BMI outside 10-80 kg/m2 range is rejected","HDL or cholesterol outside valid bounds causes error","Payment not provided or insufficient USDC results in 402 response"],"whenToPreferThis":"Choose this endpoint when you need to implement the specific Khan 2019 PCP-HF Table 2 model for 10-year heart failure risk in a primary care context for adults aged 30-79, and you have all 12 required clinical inputs including QRS duration. Do not use for PREVENT 2024, PCE 2013, diagnosis, or treatment orders. Prefer this over generic cardiovascular calculators when HF-specific risk (not ASCVD) is the clinical question.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:48:34.247Z","isFirstParty":false}