◈ Health Risk Intelligence API

Clinical-grade predictions.
One unified API.

Interactive Playground

Select an endpoint, edit the request body, and hit Run to call the live API.

POST
Request Body
Response
Click "Run" to send the request...

API Endpoints

Every endpoint returns a unified JSON envelope with prediction, confidence, risk level, and actionable insights.

Risk Prediction
POST /api/v1/risk/diabetes Diabetes risk from 8 clinical markers

Predicts diabetes probability using a Gradient Boosting model trained on the Pima Indians Diabetes Database (768 samples). Handles physiologically impossible zero values via median imputation.

Request Fields

FieldTypeRequiredDescription
pregnanciesintegerYesNumber of pregnancies (0–20)
glucosenumberYesPlasma glucose concentration (mg/dL)
blood_pressurenumberYesDiastolic blood pressure (mmHg)
skin_thicknessnumberYesTriceps skinfold thickness (mm)
insulinnumberYes2-hour serum insulin (μU/mL). Use 0 if unknown.
bminumberYesBody mass index (kg/m²)
diabetes_pedigreenumberYesDiabetes pedigree function (family history score)
ageintegerYesAge in years

Example Request

JSON
"pregnancies": 2, "glucose": 138, "blood_pressure": 80, "skin_thickness": 22, "insulin": 0, "bmi": 26.5, "diabetes_pedigree": 0.351, "age": 29
POST /api/v1/risk/heart Heart disease risk from 9 cardiac markers

Random Forest model trained on 1,943 combined records from the Cleveland Heart Disease study and Heart Failure Prediction dataset. Cholesterol=0 is treated as missing and median-imputed.

Request Fields

FieldTypeRequiredDescription
ageintegerYesAge in years
sexintegerYes0 = Female, 1 = Male
chest_pain_typeintegerYes0=Asymptomatic, 1=Atypical Angina, 2=Non-Anginal, 3=Typical Angina
resting_bpnumberYesResting blood pressure (mmHg)
cholesterolnumberYesSerum cholesterol (mg/dL). Use 0 if unknown.
fasting_bsintegerYesFasting blood sugar >120 mg/dL (1=True, 0=False)
max_hrnumberYesMaximum heart rate achieved (bpm)
exercise_anginaintegerYesExercise-induced angina (1=Yes, 0=No)
oldpeaknumberYesST depression induced by exercise
POST /api/v1/risk/stroke Stroke risk from demographic and clinical data

Histogram Gradient Boosting with adjusted class weights (1:20) to handle severe class imbalance (4.8% positive rate in training data). Decision threshold is set to 0.30 for high-recall detection — high_risk_flag is true when probability ≥ 0.30.

Request Fields

FieldTypeRequiredDescription
genderstringYesMale, Female, Other
agenumberYesAge in years
hypertensionintegerYes1=Yes, 0=No
heart_diseaseintegerYes1=Yes, 0=No
ever_marriedstringYesYes or No
work_typestringYesPrivate, Self-employed, Govt_job, children, Never_worked
residence_typestringYesUrban or Rural
avg_glucose_levelnumberYesAverage glucose level (mg/dL)
bminumberYesBMI (kg/m²)
smoking_statusstringYesformerly smoked, never smoked, smokes, Unknown
POST /api/v1/risk/breast-cancer Breast tumor malignancy from 30 biopsy measurements

SVM with RBF kernel trained on the Wisconsin Diagnostic dataset (569 samples, ~97% 10-fold CV accuracy). Input grouped into mean, standard error, and worst-case measurements of 10 nucleus characteristics.

Request Structure

{ "mean_features": { radius, texture, perimeter, area, smoothness, compactness, concavity, concave_points, symmetry, fractal_dimension }, "se_features": { same 10 fields }, "worst_features": { same 10 fields } }
POST /api/v1/risk/comprehensive Multi-disease risk profile — diabetes + heart + stroke simultaneously

Runs all three risk models from a single consolidated input. Returns individual scores for each condition plus an overall risk level and the highest-concern condition. Ideal for initial patient screening. Shared fields (age, sex, bmi, blood_pressure) are dispatched to each model automatically.

Medical Imaging
POST /api/v1/imaging/brain-tumor Brain MRI tumor classification (4 classes)

MobileNetV2 fine-tuned on ~7,200 brain MRI images, exported to INT8-quantized ONNX (~3.5MB). Classifies into: glioma, meningioma, pituitary tumor, or no tumor. Accepts base64-encoded JPEG or PNG.

Request Fields

FieldTypeRequiredDescription
image_base64stringYesBase64-encoded JPEG or PNG brain MRI image

Response Classes

"glioma" | "meningioma" | "pituitary" | "notumor"
Wellness & Lifestyle
POST /api/v1/wellness/sleep Sleep disorder risk + lifestyle wellness score

Random Forest classifier trained on the Sleep Health and Lifestyle Dataset (374 samples). Predicts None, Insomnia, or Sleep Apnea probability. Also returns a composite wellness score (0–100) from sleep duration, quality, daily steps, and stress level.

Key Fields

FieldTypeDescription
occupationstringSoftware Engineer, Doctor, Nurse, Teacher, Accountant, Lawyer, etc.
bmi_categorystringNormal, Overweight, Obese
systolic_bp / diastolic_bpintegerBlood pressure components (split from the "126/83" format)
POST /api/v1/wellness/activity Fitness percentile vs. FitBit reference population

Compares your daily activity metrics against pre-computed percentiles from 33 FitBit users (2016). Returns steps/calories/active-minutes percentiles and a fitness category. Reference is a small convenience sample — use as indicative benchmarks only.

Population Analytics
POST /api/v1/population/life-expectancy Country life expectancy from WHO health indicators

Gradient Boosting Regressor trained on WHO data for 193 countries (2000–2015). Accepts 19 socioeconomic and health indicators and predicts life expectancy in years with a 90% confidence interval.

GET /api/v1/analytics/hospital Hospital admission statistics by condition & age group

Returns pre-aggregated analytics from 55,500 patient records across 6 conditions and 5 age groups. Includes billing statistics, admission type breakdown, length of stay, medication patterns, and insurance distribution.

Query Parameters

ParameterRequiredValues
conditionYesArthritis, Asthma, Cancer, Diabetes, Hypertension, Obesity
age_groupNo0-17, 18-34, 35-49, 50-64, 65+

Example

GET /api/v1/analytics/hospital?condition=Diabetes&age_group=50-64
Insurance Cost Estimation
POST /api/v1/insurance/estimate Annual medical insurance cost prediction with 90% confidence interval

Three Gradient Boosting Regressors — mean estimate, 5th percentile (lower bound), 95th percentile (upper bound). Trained on 1,338 US insurance records. The smoker×BMI interaction term is included as an explicit feature.

Request Fields

FieldTypeDescription
ageintegerAge in years
sexstringmale or female
bminumberBody mass index
childrenintegerNumber of dependents
smokerstringyes or no
regionstringsouthwest, southeast, northwest, northeast
Meta
GET /api/v1/health Health check — confirms API is running
{ "status": "ok", "version": "1.0.0" }
GET /api/v1/models Lists all loaded models with algorithm and accuracy metrics

Returns the model registry JSON including algorithm name, training dataset, CV accuracy, number of samples, and artifact SHA256 hash for each model.

12Datasets
11Endpoints
<50msInference
8ML Models

ML Models

All models are pre-trained offline and loaded at startup. No training happens at inference time.

Model Algorithm Dataset Samples Performance
Loading model registry...

AUC = Area Under ROC Curve (classification). R² = coefficient of determination (regression). Metrics from 5-fold stratified cross-validation unless noted.