Skip to content

Cholesterol Ratio Calculator API

Calculate key lipid ratios and return interpreted cardiovascular risk context in a production-ready response schema.

Endpoint

  • GET /api/v1/cholesterol-ratio-calculator
  • POST /api/v1/cholesterol-ratio-calculator/post

Parameters

Name Type Required In Description
total_cholesterol number Yes Query/Body Total cholesterol value.
hdl number Yes Query/Body HDL value.
ldl number Yes Query/Body LDL value.
tg number Yes Query/Body Triglycerides value.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Convert raw lipid panel values into meaningful risk signals.
  • Enable prevention workflows from ratio thresholds.
  • Improve lab analytics dashboards with interpretable outputs.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/cholesterol-ratio-calculator?total_cholesterol=210&hdl=48&ldl=132&tg=165&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/cholesterol-ratio-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"total_cholesterol":210,"hdl":48,"ldl":132,"tg":165}'

Response Example

Info

The response example below is for demonstration purposes only. Make a live request to this endpoint to receive the full, real-time, and potentially richer JSON structure.

{
  "ldl_hdl_ratio": 2.75,
  "tg_hdl_ratio": 3.44,
  "tc_hdl_ratio": 4.38,
  "ldl_hdl_meaning": "Good",
  "tg_hdl_meaning": "High",
  "tc_hdl_meaning": "Good",
  "overall_risk_band": "moderate_risk",
  "overall_risk_label": "Moderate Risk",
  "risk_signal": "Intermediate lipid-risk pattern detected.",
  "action_plan": ["Improve lipid profile inputs", "Recheck panel in follow-up window"],
  "monitoring_plan": "Repeat lipid trends periodically.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "f0ec2b3140dcb593",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "cholesterol_ratio_calculator",
    "response_language": "en"
  }
}

Product Fit

Ideal for cardiometabolic risk apps, preventive care software, and corporate health analytics.

Note

total_cholesterol, hdl, and ldl must be positive; tg cannot be negative.