{"openapi":"3.1.0","info":{"title":"Apex Cardio-Fitness Scores API","version":"0.1.0","description":"Stateless, read-only educational calculators: CHA2DS2-VASc and a cardiovascular health score based on AHA Life's Essential 8. Computes only from values in the query string; nothing is stored or logged. Operated by Indus Intellect LLC. educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician."},"servers":[{"url":"https://cardio.apexacademy.cloud"}],"paths":{"/api/connector":{"get":{"operationId":"calculate","summary":"Run a score (tool=cha2ds2vasc|le8) or list tools (tool=list)","parameters":[{"name":"tool","in":"query","required":true,"schema":{"type":"string","enum":["cha2ds2vasc","le8","list"]}},{"name":"age","in":"query","schema":{"type":"integer","minimum":18,"maximum":120},"description":"cha2ds2vasc, required."},{"name":"sex","in":"query","schema":{"type":"string","enum":["female","male"]},"description":"cha2ds2vasc, required."},{"name":"chf","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"cha2ds2vasc, required."},{"name":"hypertension","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"cha2ds2vasc, required."},{"name":"diabetes","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"cha2ds2vasc (required) and le8 (glucose)."},{"name":"stroke_tia_te","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"cha2ds2vasc, required."},{"name":"vascular","in":"query","schema":{"type":"integer","enum":[0,1]},"description":"cha2ds2vasc, required."},{"name":"diet_mepa_score","in":"query","schema":{"type":"integer","minimum":0,"maximum":16}},{"name":"pa_minutes_week","in":"query","schema":{"type":"integer","minimum":0,"maximum":10080}},{"name":"nicotine","in":"query","schema":{"type":"string","enum":["never","former_ge5y","former_1_5y","former_lt1y_or_ecig","current"]}},{"name":"secondhand","in":"query","schema":{"type":"integer","enum":[0,1]}},{"name":"sleep_hours","in":"query","schema":{"type":"number","minimum":0,"maximum":24}},{"name":"bmi","in":"query","schema":{"type":"number","minimum":10,"maximum":80}},{"name":"non_hdl_mgdl","in":"query","schema":{"type":"integer","minimum":40,"maximum":600}},{"name":"lipid_meds","in":"query","schema":{"type":"integer","enum":[0,1]}},{"name":"fasting_glucose_mgdl","in":"query","schema":{"type":"integer","minimum":30,"maximum":900}},{"name":"hba1c_pct","in":"query","schema":{"type":"number","minimum":3,"maximum":20}},{"name":"sbp","in":"query","schema":{"type":"integer","minimum":50,"maximum":300}},{"name":"dbp","in":"query","schema":{"type":"integer","minimum":30,"maximum":200}},{"name":"bp_meds","in":"query","schema":{"type":"integer","enum":[0,1]}}],"responses":{"200":{"description":"Result. Every response carries disclaimer and citation.","content":{"application/json":{"examples":{"cha2ds2vasc":{"summary":"76-year-old woman with hypertension","value":{"disclaimer":"educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician","citation":"Lip GY et al. Chest 2010;137:263-272. DOI 10.1378/chest.09-1584","tool":"cha2ds2vasc","score":"CHA2DS2-VASc","components":[{"item":"Congestive heart failure / LV dysfunction","points":0},{"item":"Hypertension","points":1},{"item":"Age >=75","points":2},{"item":"Diabetes mellitus","points":0},{"item":"Stroke / TIA / thromboembolism","points":0},{"item":"Vascular disease (prior MI, PAD, aortic plaque)","points":0},{"item":"Age 65-74","points":0},{"item":"Sex category (female)","points":1}],"total":4,"max_total":9,"cha2ds2va":3,"cha2ds2va_note":"CHA2DS2-VA is the same score without the sex-category point. The 2024 ESC atrial fibrillation guideline uses CHA2DS2-VA (Van Gelder IC et al. 2024 ESC Guidelines for the management of atrial fibrillation. Eur Heart J 2024. DOI 10.1093/eurheartj/ehae176).","note":"This is a point count only. It is not a stroke-risk percentage or a treatment recommendation."}},"le8_full":{"summary":"All eight metrics provided: composite is the mean","value":{"disclaimer":"educational calculation; not medical advice, diagnosis or a treatment recommendation; discuss with a clinician","citation":"Lloyd-Jones DM et al. Life's Essential 8. Circulation 2022;146:e18-e43. DOI 10.1161/CIR.0000000000001078 (adult scoring table)","tool":"le8","score":"cardiovascular health score based on AHA Life's Essential 8","attribution":"Scoring rules from the American Heart Association's Life's Essential 8 (Lloyd-Jones et al., Circulation 2022). This service is independent and is not endorsed by the AHA.","metrics":[{"metric":"diet","input":{"diet_mepa_score":12},"points":80,"table_row":"MEPA 12-14"},{"metric":"physical_activity","input":{"pa_minutes_week":90},"points":80,"table_row":"90-119"},{"metric":"nicotine_exposure","input":{"nicotine":"former_1_5y","secondhand":null},"points":50,"table_row":"Former smoker, quit 1-<5 y"},{"metric":"sleep_health","input":{"sleep_hours":6.5},"points":70,"table_row":"6-<7 h"},{"metric":"bmi","input":{"bmi":27},"points":70,"table_row":"25.0-29.9"},{"metric":"blood_lipids","input":{"non_hdl_mgdl":140,"lipid_meds":null},"points":60,"table_row":"130-159"},{"metric":"blood_glucose","input":{"fasting_glucose_mgdl":110,"hba1c_pct":null,"diabetes":0},"points":60,"table_row":"No diabetes, FBG 100-125 (or HbA1c 5.7-6.4) (prediabetes)"},{"metric":"blood_pressure","input":{"sbp":125,"dbp":75,"bp_meds":null},"points":75,"table_row":"120-129/<80 (elevated)"}],"metrics_used":8,"composite":68.1,"composite_note":"Unweighted mean of the 8 metric scores.","not_applied":"Optional clinician-judgment adjustments (sleep apnea, metformin in prediabetes, ancestry-specific BMI table, underweight, DASH/HEI population percentiles) are not applied."}}}}}},"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":"Lip GY et al. Chest 2010;137:263-272. DOI 10.1378/chest.09-1584; Lloyd-Jones DM et al. Life's Essential 8. Circulation 2022;146:e18-e43. DOI 10.1161/CIR.0000000000001078 (adult scoring table)","error":{"code":"invalid_parameter","message":"age must be a number from 18 to 120 (whole number)."}}}}},"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":"Lip GY et al. Chest 2010;137:263-272. DOI 10.1378/chest.09-1584; Lloyd-Jones DM et al. Life's Essential 8. Circulation 2022;146:e18-e43. DOI 10.1161/CIR.0000000000001078 (adult scoring table)","error":{"code":"method_not_allowed","message":"This connector is read-only. Use GET."}}}}}}}}}}