{"openapi":"3.1.0","info":{"title":"Apex ASCVD Risk Calculator API","version":"0.1.0","description":"Stateless, read-only educational calculator of the 2013 ACC/AHA Pooled Cohort Equations (superseded; race-based; overestimates risk in contemporary cohorts). Computes only from values in the query string; query values are neither stored nor logged. Operated by Indus Intellect LLC. educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician."},"servers":[{"url":"https://ascvd.apexacademy.cloud"}],"paths":{"/api/connector":{"get":{"operationId":"calculate","summary":"Run tool=pce, or read tool=prevent (placeholder) or tool=list","parameters":[{"name":"tool","in":"query","required":true,"schema":{"type":"string","enum":["pce","prevent","list"]}},{"name":"age","in":"query","schema":{"type":"integer","minimum":40,"maximum":79},"description":"pce, required."},{"name":"sex","in":"query","schema":{"type":"string","enum":["female","male"]},"description":"pce, required."},{"name":"race","in":"query","schema":{"type":"string","enum":["white","african_american","other"]},"description":"pce, required. other uses the white equations."},{"name":"total_chol_mgdl","in":"query","schema":{"type":"integer","minimum":130,"maximum":320},"description":"pce, required."},{"name":"hdl_mgdl","in":"query","schema":{"type":"integer","minimum":20,"maximum":100},"description":"pce, required."},{"name":"sbp","in":"query","schema":{"type":"integer","minimum":90,"maximum":200},"description":"pce, required. Systolic BP, mm Hg."},{"name":"bp_treated","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"pce, required."},{"name":"diabetes","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"pce, required."},{"name":"smoker","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"pce, required."}],"responses":{"200":{"description":"Result. Every response carries disclaimer and citation.","content":{"application/json":{"examples":{"pce":{"summary":"Guideline example: 55-year-old white woman","value":{"disclaimer":"educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician","citation":"Goff DC Jr et al. 2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk. Circulation 2014;129(25 Suppl 2):S49-S73. DOI 10.1161/01.cir.0000437741.48606.98 (Appendix 7, Table A)","tool":"pce","score":"2013 ACC/AHA Pooled Cohort Equations, 10-year risk of a first hard ASCVD event (nonfatal MI, CHD death, fatal or nonfatal stroke)","model_used":"white female","race_note":null,"risk_10y_pct":2.1,"category":"low (<5%)","category_note":"Bands from the 2013/2018 ACC/AHA guidelines (low <5%, borderline 5-7.4%, intermediate 7.5-19.9%, high >=20%), applied to the 1-decimal risk shown. A category is a label, not a treatment recommendation.","superseded":"Superseded for clinical use: the 2026 ACC/AHA Guideline on the Management of Dyslipidemia. DOI 10.1161/CIR.0000000000001423 uses the AHA PREVENT equations for primary prevention. The PCE is shown for education and comparison only. The PCE is race-based and is known to overestimate risk in contemporary cohorts.","validated_ranges":"age 40-79, total cholesterol 130-320 mg/dL, HDL-C 20-100 mg/dL, systolic BP 90-200 mm Hg."}},"prevent":{"summary":"Placeholder","value":{"disclaimer":"educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician","citation":"2026 ACC/AHA Guideline on the Management of Dyslipidemia. DOI 10.1161/CIR.0000000000001423","tool":"prevent","status":"pending AHA PREVENT licence (submitted 2026-09-29); will be added unmodified as PREVENT 1.0.0 with AHA attribution","computed":false,"note":"No calculation is performed and PREVENT is never blended with the PCE."}}}}}},"400":{"description":"Invalid or missing parameter","content":{"application/json":{"example":{"disclaimer":"educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician","citation":"Goff DC Jr et al. 2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk. Circulation 2014;129(25 Suppl 2):S49-S73. DOI 10.1161/01.cir.0000437741.48606.98 (Appendix 7, Table A)","error":{"code":"invalid_parameter","message":"age must be a whole number from 40 to 79 (the range the equations were validated for)."}}}}},"405":{"description":"Method other than GET, HEAD or OPTIONS (Allow: GET, HEAD, OPTIONS)","content":{"application/json":{"example":{"disclaimer":"educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician","citation":"Goff DC Jr et al. 2013 ACC/AHA Guideline on the Assessment of Cardiovascular Risk. Circulation 2014;129(25 Suppl 2):S49-S73. DOI 10.1161/01.cir.0000437741.48606.98 (Appendix 7, Table A)","error":{"code":"method_not_allowed","message":"This connector is read-only. Use GET."}}}}}}}}}}