Skip to content

Cardiovascular Age API

Estimate biological cardiovascular age relative to chronological age using common cardiometabolic markers.

Endpoint

  • GET /api/v1/health/cardiovascular-age
  • POST /api/v1/health/cardiovascular-age/post

Parameters

Name Type Required In Description
age integer (20-85) Yes Query/Body Chronological age.
systolic_bp number Yes Query/Body Systolic blood pressure in mmHg.
diastolic_bp number Yes Query/Body Diastolic blood pressure in mmHg.
resting_hr number Yes Query/Body Resting heart rate in bpm.
cholesterol_ratio number Yes Query/Body Total-to-HDL cholesterol ratio.
smoking_status string Yes Query/Body never, former, or active.
lang string No Query Response language (en,fr,es,de,pt,ja,hi,ar,bn,gu,id,it,ko,mr,nl,pa,pl,ro,ru,ta,te,th,tr,ur,vi,zh).

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/health/cardiovascular-age?age=42&systolic_bp=128&diastolic_bp=82&resting_hr=68&cholesterol_ratio=4.1&smoking_status=former&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

Response Example

{
  "chronological_age": 42,
  "systolic_bp": 128.0,
  "diastolic_bp": 82.0,
  "resting_hr": 68.0,
  "cholesterol_ratio": 4.1,
  "smoking_status": "former",
  "cardiovascular_age": 45.0,
  "risk_category": "elevated",
  "risk_category_label": "Elevated cardiovascular risk",
  "summary": "Cardiovascular markers show mild elevation. Focus on aerobic conditioning and dietary optimization.",
  "recommendations": ["Increase weekly low-intensity steady-state cardiovascular volume."],
  "language": "en",
  "_api_metadata_": {"endpoint_name": "cardiovascular_age", "response_language": "en"}
}

Localization

This endpoint reads health_fitness_cardiovascular_age.json from the supported language catalogs.