Skip to content

Diabetes Risk API

Calculate diabetes risk percentage from age, sex, ethnicity, glucose, blood pressure, HDL, BMI context, and family history.

Endpoint

  • GET /api/v1/diabetes-risk
  • POST /api/v1/diabetes-risk/post

Parameters

Name Type Required In Description
age integer Yes Query/Body Age in years.
sex integer Yes Query/Body Encoded sex value expected by model.
ethnicity integer Yes Query/Body Encoded ethnicity value expected by model.
weight number Yes Query/Body Body weight (kg metric, lb imperial).
height number Yes Query/Body Height (cm metric, in imperial).
fasting_glucose number Yes Query/Body Fasting glucose value.
systolic_blood_pressure number Yes Query/Body Systolic BP reading.
HDL_cholesterol number Yes Query/Body HDL cholesterol value.
family_history integer Yes Query/Body Family-history marker (model input).
unit string (metric,imperial) No Query/Body Weight/height unit mode.
lang string No Query Response language (en,es,de,fr,pt,ja,hi,ar).

Why Use This Endpoint

  • Turn clinical markers into a unified diabetes risk score.
  • Power preventive alerts and triage workflows.
  • Standardize risk logic across partners and platforms.

Get Started

Request Example

curl -X GET "https://api.hefitapi.com/api/v1/diabetes-risk?age=45&sex=1&ethnicity=1&weight=84&height=177&fasting_glucose=112&systolic_blood_pressure=132&HDL_cholesterol=46&family_history=1&unit=metric&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/diabetes-risk/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":45,"sex":1,"ethnicity":1,"weight":84,"height":177,"fasting_glucose":112,"systolic_blood_pressure":132,"HDL_cholesterol":46,"family_history":1,"unit":"metric"}'

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.

{
  "age": 45,
  "BMI": 26.81,
  "diabetes_risk": 28.47,
  "risk_band": "moderate",
  "risk_band_label": "Moderate",
  "risk_signal": "Moderate diabetes risk pattern detected.",
  "action_plan": ["Improve insulin-sensitive habits", "Follow periodic screening"],
  "monitoring_plan": "Recheck markers in planned intervals.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "7a4ac23db2db4f7a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "diabetes_risk",
    "response_language": "en"
  }
}

Commercial Positioning

High-value endpoint for preventive care products, insurer risk engines, and chronic disease monitoring systems.

Note

Model expects numeric coded inputs for sex, ethnicity, and family_history.