{"openapi":"3.1.0","info":{"title":"VitalCheck API","description":"**VitalCheck** is a ML-powered health risk intelligence API built on 12 healthcare datasets. It provides instant risk assessments for diabetes, heart disease, stroke, breast cancer, brain tumor classification, sleep disorders, insurance cost estimation, and population health analytics.\n\n> This API is for informational and research purposes only. It is not a medical device and must not be used for clinical diagnosis or treatment decisions.","contact":{"name":"VitalCheck API","url":"https://github.com/"},"license":{"name":"MIT"},"version":"1.0.0"},"paths":{"/api/v1/risk/diabetes":{"post":{"tags":["Risk Prediction"],"summary":"Diabetes Risk Prediction","description":"Predicts diabetes risk from 8 clinical markers using a Gradient Boosting model trained on the Pima Indians Diabetes Database (768 samples). Returns probability, risk level, and top contributing features.","operationId":"predict_diabetes_api_v1_risk_diabetes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiabetesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_DiabetesPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/risk/heart":{"post":{"tags":["Risk Prediction"],"summary":"Heart Disease Risk Prediction","description":"Predicts heart disease risk using a Random Forest model trained on a combined dataset from the Cleveland Heart Disease study and the Heart Failure Prediction dataset (1943 samples total). Features are harmonized to a common 9-feature schema.","operationId":"predict_heart_api_v1_risk_heart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_HeartPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/risk/stroke":{"post":{"tags":["Risk Prediction"],"summary":"Stroke Risk Prediction","description":"Predicts stroke probability using a Histogram Gradient Boosting model trained on 5109 patient records. The positive class is severely imbalanced (4.8% stroke rate), so the model uses adjusted class weights and a 0.30 decision threshold for high recall.","operationId":"predict_stroke_api_v1_risk_stroke_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrokeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_StrokePrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/risk/breast-cancer":{"post":{"tags":["Risk Prediction"],"summary":"Breast Cancer Malignancy Prediction","description":"Predicts breast tumor malignancy from 30 biopsy measurements using an SVM with RBF kernel trained on the Wisconsin Diagnostic Breast Cancer dataset (569 samples, ~97% CV accuracy). Input features are grouped into mean, standard error, and worst-case measurements.","operationId":"predict_breast_cancer_api_v1_risk_breast_cancer_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BreastCancerRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_BreastCancerPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/risk/comprehensive":{"post":{"tags":["Risk Prediction"],"summary":"Comprehensive Multi-Disease Risk Profile","description":"Runs diabetes, heart disease, and stroke models simultaneously from a shared set of inputs. Returns a unified risk profile identifying the highest-concern condition. Ideal for initial patient screening workflows.","operationId":"predict_comprehensive_api_v1_risk_comprehensive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComprehensiveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_ComprehensivePrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/imaging/brain-tumor":{"post":{"tags":["Medical Imaging"],"summary":"Brain Tumor MRI Classification","description":"Classifies a brain MRI image into one of four categories: glioma, meningioma, pituitary tumor, or no tumor. Uses a MobileNetV2 model fine-tuned on ~7200 brain MRI images and exported to INT8-quantized ONNX format (~3.5MB). Accepts a base64-encoded JPEG or PNG image. **Note:** This is a research-grade classifier and not a certified diagnostic tool.","operationId":"classify_brain_tumor_api_v1_imaging_brain_tumor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrainTumorRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_BrainTumorPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wellness/sleep":{"post":{"tags":["Wellness & Lifestyle"],"summary":"Sleep Disorder Risk Assessment","description":"Predicts sleep disorder risk (None, Insomnia, or Sleep Apnea) from lifestyle and biometric inputs. Model trained on the Sleep Health and Lifestyle Dataset (374 samples, Random Forest). Also returns a composite lifestyle wellness score (0–100).","operationId":"predict_sleep_api_v1_wellness_sleep_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SleepRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_SleepPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wellness/activity":{"post":{"tags":["Wellness & Lifestyle"],"summary":"Fitness Activity Percentile Analysis","description":"Compares your daily activity metrics against a FitBit reference population of 33 users (2016 study). Returns percentile rankings for steps, calories, and active minutes, plus a fitness category. **Note:** Reference population is a small convenience sample — percentiles are indicative, not clinically validated.","operationId":"analyze_activity_api_v1_wellness_activity_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_ActivityPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/population/life-expectancy":{"post":{"tags":["Population Analytics"],"summary":"Country Life Expectancy Prediction","description":"Predicts national life expectancy in years from 19 WHO health and socioeconomic indicators. Model trained on WHO data covering 193 countries (2000–2015). Useful for public health policy analysis and global health research.","operationId":"predict_life_expectancy_api_v1_population_life_expectancy_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifeExpectancyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_LifeExpectancyPrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/analytics/hospital":{"get":{"tags":["Population Analytics"],"summary":"Hospital Admission Analytics","description":"Returns pre-aggregated hospital admission statistics by medical condition and age group. Data derived from 55,500 synthetic patient records across 6 conditions and 5 age groups. Valid conditions: Arthritis, Asthma, Cancer, Diabetes, Hypertension, Obesity. Valid age groups: 0-17, 18-34, 35-49, 50-64, 65+ (optional).","operationId":"get_hospital_analytics_api_v1_analytics_hospital_get","parameters":[{"name":"condition","in":"query","required":true,"schema":{"type":"string","description":"Medical condition to query","examples":["Diabetes"],"title":"Condition"},"description":"Medical condition to query"},{"name":"age_group","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Age group filter (optional)","examples":["50-64"],"title":"Age Group"},"description":"Age group filter (optional)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_HospitalAnalyticsResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/insurance/estimate":{"post":{"tags":["Insurance Cost Estimation"],"summary":"Medical Insurance Cost Estimation","description":"Estimates annual medical insurance charges from 6 demographic and lifestyle factors. Uses three Gradient Boosting Regressor models for the mean estimate and 90% prediction interval. Trained on 1,338 US insurance records. Useful for premium benchmarking and actuarial modeling.","operationId":"estimate_insurance_api_v1_insurance_estimate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsuranceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VitalCheckResponse_InsurancePrediction_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/health":{"get":{"tags":["Meta"],"summary":"Health Check","operationId":"health_check_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/models":{"get":{"tags":["Meta"],"summary":"List Models & Accuracy","operationId":"list_models_api_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActivityPrediction":{"properties":{"steps_percentile":{"type":"number","title":"Steps Percentile","description":"Steps percentile vs. FitBit reference population"},"calories_percentile":{"type":"number","title":"Calories Percentile","description":"Calorie burn percentile vs. reference population"},"active_minutes_percentile":{"type":"number","title":"Active Minutes Percentile","description":"Very active minutes percentile"},"fitness_category":{"type":"string","title":"Fitness Category","description":"Fitness category: Sedentary | Lightly Active | Active | Very Active"},"vs_population_summary":{"type":"string","title":"Vs Population Summary","description":"Human-readable comparison to reference population"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"reference_population_note":{"type":"string","title":"Reference Population Note","default":"Reference population is 33 FitBit users from a 2016 convenience sample. Percentiles are indicative, not clinically validated benchmarks."}},"type":"object","required":["steps_percentile","calories_percentile","active_minutes_percentile","fitness_category","vs_population_summary","recommendations"],"title":"ActivityPrediction"},"ActivityRequest":{"properties":{"total_steps":{"type":"integer","minimum":0.0,"title":"Total Steps","description":"Total daily steps","examples":[8200]},"calories":{"type":"number","exclusiveMinimum":0.0,"title":"Calories","description":"Daily calories burned","examples":[2150]},"very_active_minutes":{"type":"integer","minimum":0.0,"title":"Very Active Minutes","description":"Minutes of very active exercise","examples":[35]},"fairly_active_minutes":{"type":"integer","minimum":0.0,"title":"Fairly Active Minutes","description":"Minutes of fairly active exercise","examples":[20]},"lightly_active_minutes":{"type":"integer","minimum":0.0,"title":"Lightly Active Minutes","description":"Minutes of light activity","examples":[180]},"sedentary_minutes":{"type":"integer","minimum":0.0,"title":"Sedentary Minutes","description":"Minutes sedentary (excluding sleep)","examples":[720]},"total_distance_km":{"type":"number","minimum":0.0,"title":"Total Distance Km","description":"Total distance traveled (km)","examples":[5.8]}},"type":"object","required":["total_steps","calories","very_active_minutes","fairly_active_minutes","lightly_active_minutes","sedentary_minutes","total_distance_km"],"title":"ActivityRequest"},"BrainTumorPrediction":{"properties":{"predicted_class":{"type":"string","enum":["glioma","meningioma","pituitary","notumor"],"title":"Predicted Class","description":"Predicted tumor classification"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","description":"Confidence score for the predicted class"},"tumor_detected":{"type":"boolean","title":"Tumor Detected","description":"True if a tumor was detected (class != notumor)"},"class_probabilities":{"additionalProperties":{"type":"number"},"type":"object","title":"Class Probabilities","description":"Softmax probabilities for each class"}},"type":"object","required":["predicted_class","confidence","tumor_detected","class_probabilities"],"title":"BrainTumorPrediction"},"BrainTumorRequest":{"properties":{"image_base64":{"type":"string","title":"Image Base64","description":"Base64-encoded JPEG or PNG MRI image (T1-weighted brain MRI)","examples":["<base64-encoded image string>"]}},"type":"object","required":["image_base64"],"title":"BrainTumorRequest"},"BreastCancerMeanFeatures":{"properties":{"radius":{"type":"number","exclusiveMinimum":0.0,"title":"Radius","description":"Mean radius","examples":[17.99]},"texture":{"type":"number","exclusiveMinimum":0.0,"title":"Texture","description":"Mean texture","examples":[10.38]},"perimeter":{"type":"number","exclusiveMinimum":0.0,"title":"Perimeter","description":"Mean perimeter","examples":[122.8]},"area":{"type":"number","exclusiveMinimum":0.0,"title":"Area","description":"Mean area","examples":[1001.0]},"smoothness":{"type":"number","exclusiveMinimum":0.0,"title":"Smoothness","description":"Mean smoothness","examples":[0.1184]},"compactness":{"type":"number","exclusiveMinimum":0.0,"title":"Compactness","description":"Mean compactness","examples":[0.2776]},"concavity":{"type":"number","exclusiveMinimum":0.0,"title":"Concavity","description":"Mean concavity","examples":[0.3001]},"concave_points":{"type":"number","exclusiveMinimum":0.0,"title":"Concave Points","description":"Mean concave points","examples":[0.1471]},"symmetry":{"type":"number","exclusiveMinimum":0.0,"title":"Symmetry","description":"Mean symmetry","examples":[0.2419]},"fractal_dimension":{"type":"number","exclusiveMinimum":0.0,"title":"Fractal Dimension","description":"Mean fractal dimension","examples":[0.07871]}},"type":"object","required":["radius","texture","perimeter","area","smoothness","compactness","concavity","concave_points","symmetry","fractal_dimension"],"title":"BreastCancerMeanFeatures"},"BreastCancerPrediction":{"properties":{"diagnosis":{"type":"string","title":"Diagnosis","description":"Predicted diagnosis: Malignant or Benign"},"malignant_probability":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Malignant Probability"},"benign_probability":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Benign Probability"},"risk":{"$ref":"#/components/schemas/RiskScore"},"key_contributors":{"items":{"type":"string"},"type":"array","title":"Key Contributors"}},"type":"object","required":["diagnosis","malignant_probability","benign_probability","risk","key_contributors"],"title":"BreastCancerPrediction"},"BreastCancerRequest":{"properties":{"mean_features":{"$ref":"#/components/schemas/BreastCancerMeanFeatures"},"se_features":{"$ref":"#/components/schemas/BreastCancerSEFeatures"},"worst_features":{"$ref":"#/components/schemas/BreastCancerWorstFeatures"}},"type":"object","required":["mean_features","se_features","worst_features"],"title":"BreastCancerRequest"},"BreastCancerSEFeatures":{"properties":{"radius":{"type":"number","exclusiveMinimum":0.0,"title":"Radius","examples":[1.095]},"texture":{"type":"number","exclusiveMinimum":0.0,"title":"Texture","examples":[0.9053]},"perimeter":{"type":"number","exclusiveMinimum":0.0,"title":"Perimeter","examples":[8.589]},"area":{"type":"number","exclusiveMinimum":0.0,"title":"Area","examples":[153.4]},"smoothness":{"type":"number","exclusiveMinimum":0.0,"title":"Smoothness","examples":[0.006399]},"compactness":{"type":"number","exclusiveMinimum":0.0,"title":"Compactness","examples":[0.04904]},"concavity":{"type":"number","exclusiveMinimum":0.0,"title":"Concavity","examples":[0.05373]},"concave_points":{"type":"number","exclusiveMinimum":0.0,"title":"Concave Points","examples":[0.01587]},"symmetry":{"type":"number","exclusiveMinimum":0.0,"title":"Symmetry","examples":[0.03003]},"fractal_dimension":{"type":"number","exclusiveMinimum":0.0,"title":"Fractal Dimension","examples":[0.006193]}},"type":"object","required":["radius","texture","perimeter","area","smoothness","compactness","concavity","concave_points","symmetry","fractal_dimension"],"title":"BreastCancerSEFeatures"},"BreastCancerWorstFeatures":{"properties":{"radius":{"type":"number","exclusiveMinimum":0.0,"title":"Radius","examples":[25.38]},"texture":{"type":"number","exclusiveMinimum":0.0,"title":"Texture","examples":[17.33]},"perimeter":{"type":"number","exclusiveMinimum":0.0,"title":"Perimeter","examples":[184.6]},"area":{"type":"number","exclusiveMinimum":0.0,"title":"Area","examples":[2019.0]},"smoothness":{"type":"number","exclusiveMinimum":0.0,"title":"Smoothness","examples":[0.1622]},"compactness":{"type":"number","exclusiveMinimum":0.0,"title":"Compactness","examples":[0.6656]},"concavity":{"type":"number","exclusiveMinimum":0.0,"title":"Concavity","examples":[0.7119]},"concave_points":{"type":"number","exclusiveMinimum":0.0,"title":"Concave Points","examples":[0.2654]},"symmetry":{"type":"number","exclusiveMinimum":0.0,"title":"Symmetry","examples":[0.4601]},"fractal_dimension":{"type":"number","exclusiveMinimum":0.0,"title":"Fractal Dimension","examples":[0.1189]}},"type":"object","required":["radius","texture","perimeter","area","smoothness","compactness","concavity","concave_points","symmetry","fractal_dimension"],"title":"BreastCancerWorstFeatures"},"ComprehensivePrediction":{"properties":{"diabetes":{"$ref":"#/components/schemas/RiskScore"},"heart":{"$ref":"#/components/schemas/RiskScore"},"stroke":{"$ref":"#/components/schemas/RiskScore"},"overall_risk_level":{"type":"string","title":"Overall Risk Level","description":"Highest risk level across all three models"},"highest_concern":{"type":"string","title":"Highest Concern","description":"The condition with the highest predicted probability"},"inference_breakdown_ms":{"additionalProperties":{"type":"number"},"type":"object","title":"Inference Breakdown Ms"}},"type":"object","required":["diabetes","heart","stroke","overall_risk_level","highest_concern","inference_breakdown_ms"],"title":"ComprehensivePrediction"},"ComprehensiveRequest":{"properties":{"age":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Age","examples":[52]},"sex":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Sex","examples":[1]},"bmi":{"type":"number","maximum":70.0,"exclusiveMinimum":0.0,"title":"Bmi","examples":[28.4]},"glucose":{"type":"number","maximum":500.0,"exclusiveMinimum":0.0,"title":"Glucose","examples":[120]},"blood_pressure":{"type":"number","maximum":200.0,"exclusiveMinimum":0.0,"title":"Blood Pressure","examples":[78]},"smoking_status":{"type":"string","title":"Smoking Status","examples":["never smoked"]},"hypertension":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Hypertension","examples":[0]},"heart_disease":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Heart Disease","examples":[0]},"cholesterol":{"type":"number","maximum":700.0,"minimum":0.0,"title":"Cholesterol","examples":[210]},"max_hr":{"type":"number","maximum":250.0,"exclusiveMinimum":0.0,"title":"Max Hr","examples":[168]},"chest_pain_type":{"type":"integer","maximum":3.0,"minimum":0.0,"title":"Chest Pain Type","examples":[0]},"exercise_angina":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Exercise Angina","examples":[0]},"pregnancies":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Pregnancies","default":0,"examples":[0]},"avg_glucose_level":{"type":"number","maximum":500.0,"exclusiveMinimum":0.0,"title":"Avg Glucose Level","examples":[95]},"ever_married":{"type":"string","title":"Ever Married","default":"Yes","examples":["Yes"]},"work_type":{"type":"string","title":"Work Type","default":"Private","examples":["Private"]},"residence_type":{"type":"string","title":"Residence Type","default":"Urban","examples":["Urban"]},"diabetes_pedigree":{"type":"number","maximum":3.0,"exclusiveMinimum":0.0,"title":"Diabetes Pedigree","default":0.5,"examples":[0.5]},"skin_thickness":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Skin Thickness","default":20,"examples":[20]},"insulin":{"type":"number","maximum":900.0,"minimum":0.0,"title":"Insulin","default":0,"examples":[0]},"fasting_bs":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Fasting Bs","default":0,"examples":[0]},"oldpeak":{"type":"number","maximum":10.0,"minimum":-5.0,"title":"Oldpeak","default":0,"examples":[0]},"gender":{"type":"string","title":"Gender","default":"Male","examples":["Male"]}},"type":"object","required":["age","sex","bmi","glucose","blood_pressure","smoking_status","hypertension","heart_disease","cholesterol","max_hr","chest_pain_type","exercise_angina","avg_glucose_level"],"title":"ComprehensiveRequest"},"DiabetesPrediction":{"properties":{"risk":{"$ref":"#/components/schemas/RiskScore"},"key_contributors":{"items":{"type":"string"},"type":"array","title":"Key Contributors","description":"Top contributing risk factors"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Evidence-based lifestyle recommendations"}},"type":"object","required":["risk","key_contributors","recommendations"],"title":"DiabetesPrediction"},"DiabetesRequest":{"properties":{"pregnancies":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Pregnancies","description":"Number of pregnancies","examples":[2]},"glucose":{"type":"number","maximum":300.0,"exclusiveMinimum":0.0,"title":"Glucose","description":"Plasma glucose concentration (mg/dL)","examples":[138]},"blood_pressure":{"type":"number","maximum":200.0,"exclusiveMinimum":0.0,"title":"Blood Pressure","description":"Diastolic blood pressure (mmHg)","examples":[80]},"skin_thickness":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Skin Thickness","description":"Triceps skinfold thickness (mm)","examples":[22]},"insulin":{"type":"number","maximum":900.0,"minimum":0.0,"title":"Insulin","description":"2-hour serum insulin (mu U/ml)","examples":[0]},"bmi":{"type":"number","maximum":70.0,"exclusiveMinimum":0.0,"title":"Bmi","description":"Body mass index (kg/m²)","examples":[26.5]},"diabetes_pedigree":{"type":"number","maximum":3.0,"exclusiveMinimum":0.0,"title":"Diabetes Pedigree","description":"Diabetes pedigree function","examples":[0.351]},"age":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Age","description":"Age in years","examples":[29]}},"type":"object","required":["pregnancies","glucose","blood_pressure","skin_thickness","insulin","bmi","diabetes_pedigree","age"],"title":"DiabetesRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HeartPrediction":{"properties":{"risk":{"$ref":"#/components/schemas/RiskScore"},"key_contributors":{"items":{"type":"string"},"type":"array","title":"Key Contributors"},"dataset_sources":{"items":{"type":"string"},"type":"array","title":"Dataset Sources","default":["Cleveland Heart Disease Dataset","Heart Failure Prediction Dataset"]}},"type":"object","required":["risk","key_contributors"],"title":"HeartPrediction"},"HeartRequest":{"properties":{"age":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Age","description":"Age in years","examples":[55]},"sex":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Sex","description":"Sex (0=Female, 1=Male)","examples":[1]},"chest_pain_type":{"type":"integer","maximum":3.0,"minimum":0.0,"title":"Chest Pain Type","description":"Chest pain type (0=Asymptomatic, 1=Atypical Angina, 2=Non-Anginal Pain, 3=Typical Angina)","examples":[0]},"resting_bp":{"type":"number","maximum":300.0,"exclusiveMinimum":0.0,"title":"Resting Bp","description":"Resting blood pressure (mmHg)","examples":[132]},"cholesterol":{"type":"number","maximum":700.0,"minimum":0.0,"title":"Cholesterol","description":"Serum cholesterol (mg/dL). Use 0 if unknown.","examples":[254]},"fasting_bs":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Fasting Bs","description":"Fasting blood sugar >120 mg/dL (1=True, 0=False)","examples":[0]},"max_hr":{"type":"number","maximum":250.0,"exclusiveMinimum":0.0,"title":"Max Hr","description":"Maximum heart rate achieved (bpm)","examples":[164]},"exercise_angina":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Exercise Angina","description":"Exercise-induced angina (1=Yes, 0=No)","examples":[0]},"oldpeak":{"type":"number","maximum":10.0,"minimum":-5.0,"title":"Oldpeak","description":"ST depression induced by exercise","examples":[1.4]}},"type":"object","required":["age","sex","chest_pain_type","resting_bp","cholesterol","fasting_bs","max_hr","exercise_angina","oldpeak"],"title":"HeartRequest"},"HospitalAnalyticsResponse":{"properties":{"condition":{"type":"string","title":"Condition"},"age_group":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Group"},"total_admissions":{"type":"integer","title":"Total Admissions"},"admission_type_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Admission Type Breakdown"},"avg_billing_usd":{"type":"number","title":"Avg Billing Usd"},"median_billing_usd":{"type":"number","title":"Median Billing Usd"},"avg_length_of_stay_days":{"type":"number","title":"Avg Length Of Stay Days"},"test_result_distribution":{"additionalProperties":{"type":"number"},"type":"object","title":"Test Result Distribution"},"top_medications":{"items":{"type":"string"},"type":"array","title":"Top Medications"},"insurance_provider_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Insurance Provider Breakdown"}},"type":"object","required":["condition","age_group","total_admissions","admission_type_breakdown","avg_billing_usd","median_billing_usd","avg_length_of_stay_days","test_result_distribution","top_medications","insurance_provider_breakdown"],"title":"HospitalAnalyticsResponse"},"InsurancePrediction":{"properties":{"estimated_annual_charge_usd":{"type":"number","title":"Estimated Annual Charge Usd","description":"Predicted annual medical insurance charge (USD)"},"prediction_interval_90":{"additionalProperties":{"type":"number"},"type":"object","title":"Prediction Interval 90","description":"90% prediction interval: lower and upper bounds"},"risk_tier":{"type":"string","title":"Risk Tier","description":"Cost risk tier: Low | Medium | High | Very High"},"primary_cost_drivers":{"items":{"type":"string"},"type":"array","title":"Primary Cost Drivers","description":"Key factors driving the estimate"},"potential_savings_tips":{"items":{"type":"string"},"type":"array","title":"Potential Savings Tips","description":"Actionable tips to reduce insurance costs"}},"type":"object","required":["estimated_annual_charge_usd","prediction_interval_90","risk_tier","primary_cost_drivers","potential_savings_tips"],"title":"InsurancePrediction"},"InsuranceRequest":{"properties":{"age":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Age","description":"Age in years","examples":[35]},"sex":{"type":"string","title":"Sex","description":"Sex (male, female)","examples":["male"]},"bmi":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Bmi","description":"Body mass index (kg/m²)","examples":[27.9]},"children":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Children","description":"Number of dependents covered by insurance","examples":[0]},"smoker":{"type":"string","title":"Smoker","description":"Smoker status (yes, no)","examples":["yes"]},"region":{"type":"string","title":"Region","description":"US residential region (southwest, southeast, northwest, northeast)","examples":["southwest"]}},"type":"object","required":["age","sex","bmi","children","smoker","region"],"title":"InsuranceRequest"},"LifeExpectancyPrediction":{"properties":{"predicted_life_expectancy_years":{"type":"number","title":"Predicted Life Expectancy Years","description":"Predicted life expectancy in years"},"prediction_interval_90":{"additionalProperties":{"type":"number"},"type":"object","title":"Prediction Interval 90","description":"Approximate 90% prediction interval"},"key_drivers":{"items":{"type":"string"},"type":"array","title":"Key Drivers","description":"Top factors influencing this prediction"},"global_context":{"type":"string","title":"Global Context","description":"Contextual comparison to global averages"}},"type":"object","required":["predicted_life_expectancy_years","prediction_interval_90","key_drivers","global_context"],"title":"LifeExpectancyPrediction"},"LifeExpectancyRequest":{"properties":{"year":{"type":"integer","maximum":2030.0,"minimum":2000.0,"title":"Year","description":"Reference year","examples":[2015]},"status":{"type":"string","title":"Status","description":"Country development status (Developing, Developed)","examples":["Developing"]},"adult_mortality":{"type":"number","minimum":0.0,"title":"Adult Mortality","description":"Adult mortality rate per 1000 population","examples":[263]},"infant_deaths":{"type":"number","minimum":0.0,"title":"Infant Deaths","description":"Infant deaths per 1000 population","examples":[62]},"alcohol":{"type":"number","minimum":0.0,"title":"Alcohol","description":"Alcohol consumption (litres of pure alcohol per capita)","examples":[0.01]},"pct_expenditure":{"type":"number","minimum":0.0,"title":"Pct Expenditure","description":"Healthcare expenditure as % of GDP","examples":[71.28]},"hepatitis_b":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Hepatitis B","description":"Hepatitis B immunization coverage % among 1-year-olds","examples":[65]},"measles":{"type":"number","minimum":0.0,"title":"Measles","description":"Reported measles cases per 1000 population","examples":[1154]},"bmi":{"type":"number","exclusiveMinimum":0.0,"title":"Bmi","description":"Average BMI of the population","examples":[19.1]},"under_five_deaths":{"type":"number","minimum":0.0,"title":"Under Five Deaths","description":"Deaths under age 5 per 1000 population","examples":[83]},"polio":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Polio","description":"Polio immunization coverage % among 1-year-olds","examples":[6]},"total_expenditure":{"type":"number","minimum":0.0,"title":"Total Expenditure","description":"Government health expenditure as % of total government spending","examples":[8.16]},"diphtheria":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Diphtheria","description":"Diphtheria tetanus toxoid and pertussis immunization coverage % among 1-year-olds","examples":[65]},"hiv_aids":{"type":"number","minimum":0.0,"title":"Hiv Aids","description":"Deaths per 1000 live births due to HIV/AIDS (0–4 years)","examples":[0.1]},"gdp":{"type":"number","minimum":0.0,"title":"Gdp","description":"GDP per capita (USD)","examples":[584.26]},"population":{"type":"number","minimum":0.0,"title":"Population","description":"Country population","examples":[33736494]},"thinness_1_19":{"type":"number","minimum":0.0,"title":"Thinness 1 19","description":"Prevalence of thinness among children/adolescents (1–19 years) %","examples":[17.2]},"thinness_5_9":{"type":"number","minimum":0.0,"title":"Thinness 5 9","description":"Prevalence of thinness among children (5–9 years) %","examples":[17.3]},"income_composition":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Income Composition","description":"Human Development Index income composition (0–1)","examples":[0.479]},"schooling":{"type":"number","minimum":0.0,"title":"Schooling","description":"Average years of schooling","examples":[10.1]}},"type":"object","required":["year","status","adult_mortality","infant_deaths","alcohol","pct_expenditure","hepatitis_b","measles","bmi","under_five_deaths","polio","total_expenditure","diphtheria","hiv_aids","gdp","population","thinness_1_19","thinness_5_9","income_composition","schooling"],"title":"LifeExpectancyRequest"},"ResponseMetadata":{"properties":{"inference_ms":{"type":"number","title":"Inference Ms","description":"Wall-clock inference time in milliseconds"},"disclaimer":{"type":"string","title":"Disclaimer","default":"This API provides estimates for informational and research purposes only. It is not a medical device and must not be used for clinical diagnosis or treatment decisions. Always consult a qualified healthcare professional."},"data_sources":{"items":{"type":"string"},"type":"array","title":"Data Sources"}},"type":"object","required":["inference_ms"],"title":"ResponseMetadata"},"RiskLevel":{"type":"string","enum":["low","moderate","high","critical"],"title":"RiskLevel"},"RiskScore":{"properties":{"probability":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Probability","description":"Predicted probability (0–1)"},"risk_level":{"$ref":"#/components/schemas/RiskLevel","description":"Categorical risk tier"},"percentile":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentile","description":"Percentile vs. reference population"}},"type":"object","required":["probability","risk_level"],"title":"RiskScore"},"SleepPrediction":{"properties":{"predicted_disorder":{"type":"string","title":"Predicted Disorder","description":"Predicted sleep disorder (None, Insomnia, Sleep Apnea)"},"disorder_probabilities":{"additionalProperties":{"type":"number"},"type":"object","title":"Disorder Probabilities","description":"Probability for each disorder class"},"lifestyle_score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Lifestyle Score","description":"Composite lifestyle wellness score (0–100) derived from sleep duration, quality, steps, and stress"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Personalized lifestyle recommendations"}},"type":"object","required":["predicted_disorder","disorder_probabilities","lifestyle_score","recommendations"],"title":"SleepPrediction"},"SleepRequest":{"properties":{"gender":{"type":"string","title":"Gender","description":"Gender (Male, Female)","examples":["Female"]},"age":{"type":"integer","maximum":120.0,"minimum":1.0,"title":"Age","description":"Age in years","examples":[35]},"occupation":{"type":"string","title":"Occupation","description":"Occupation (e.g., Software Engineer, Doctor, Nurse, Teacher, Accountant, Lawyer, Sales Representative, Scientist, Manager, Engineer)","examples":["Software Engineer"]},"sleep_duration":{"type":"number","maximum":24.0,"exclusiveMinimum":0.0,"title":"Sleep Duration","description":"Average nightly sleep duration (hours)","examples":[7.0]},"quality_of_sleep":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Quality Of Sleep","description":"Subjective sleep quality rating (1–10)","examples":[7]},"physical_activity_level":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Physical Activity Level","description":"Daily physical activity level (0–100 minutes)","examples":[60]},"stress_level":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Stress Level","description":"Stress level (1=very low, 10=very high)","examples":[5]},"bmi_category":{"type":"string","title":"Bmi Category","description":"BMI category (Normal, Overweight, Obese)","examples":["Normal"]},"heart_rate":{"type":"integer","maximum":250.0,"exclusiveMinimum":0.0,"title":"Heart Rate","description":"Resting heart rate (bpm)","examples":[72]},"daily_steps":{"type":"integer","minimum":0.0,"title":"Daily Steps","description":"Daily step count","examples":[8000]},"systolic_bp":{"type":"integer","maximum":300.0,"exclusiveMinimum":0.0,"title":"Systolic Bp","description":"Systolic blood pressure (mmHg)","examples":[120]},"diastolic_bp":{"type":"integer","maximum":200.0,"exclusiveMinimum":0.0,"title":"Diastolic Bp","description":"Diastolic blood pressure (mmHg)","examples":[80]}},"type":"object","required":["gender","age","occupation","sleep_duration","quality_of_sleep","physical_activity_level","stress_level","bmi_category","heart_rate","daily_steps","systolic_bp","diastolic_bp"],"title":"SleepRequest"},"StrokePrediction":{"properties":{"risk":{"$ref":"#/components/schemas/RiskScore"},"high_risk_flag":{"type":"boolean","title":"High Risk Flag","description":"True if probability ≥ 0.30 (adjusted threshold for high-recall detection)"},"key_contributors":{"items":{"type":"string"},"type":"array","title":"Key Contributors"}},"type":"object","required":["risk","high_risk_flag","key_contributors"],"title":"StrokePrediction"},"StrokeRequest":{"properties":{"gender":{"type":"string","title":"Gender","description":"Gender (Male, Female, Other)","examples":["Male"]},"age":{"type":"number","maximum":120.0,"minimum":0.0,"title":"Age","description":"Age in years","examples":[67]},"hypertension":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Hypertension","description":"Hypertension (1=Yes, 0=No)","examples":[0]},"heart_disease":{"type":"integer","maximum":1.0,"minimum":0.0,"title":"Heart Disease","description":"Heart disease (1=Yes, 0=No)","examples":[1]},"ever_married":{"type":"string","title":"Ever Married","description":"Marital status (Yes, No)","examples":["Yes"]},"work_type":{"type":"string","title":"Work Type","description":"Work type (Private, Self-employed, Govt_job, children, Never_worked)","examples":["Private"]},"residence_type":{"type":"string","title":"Residence Type","description":"Residence type (Urban, Rural)","examples":["Urban"]},"avg_glucose_level":{"type":"number","maximum":500.0,"exclusiveMinimum":0.0,"title":"Avg Glucose Level","description":"Average glucose level (mg/dL)","examples":[228.69]},"bmi":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Bmi","description":"Body mass index (kg/m²)","examples":[36.6]},"smoking_status":{"type":"string","title":"Smoking Status","description":"Smoking status (formerly smoked, never smoked, smokes, Unknown)","examples":["formerly smoked"]}},"type":"object","required":["gender","age","hypertension","heart_disease","ever_married","work_type","residence_type","avg_glucose_level","bmi","smoking_status"],"title":"StrokeRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VitalCheckResponse_ActivityPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/ActivityPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[ActivityPrediction]"},"VitalCheckResponse_BrainTumorPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/BrainTumorPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[BrainTumorPrediction]"},"VitalCheckResponse_BreastCancerPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/BreastCancerPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[BreastCancerPrediction]"},"VitalCheckResponse_ComprehensivePrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/ComprehensivePrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[ComprehensivePrediction]"},"VitalCheckResponse_DiabetesPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/DiabetesPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[DiabetesPrediction]"},"VitalCheckResponse_HeartPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/HeartPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[HeartPrediction]"},"VitalCheckResponse_HospitalAnalyticsResponse_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/HospitalAnalyticsResponse"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[HospitalAnalyticsResponse]"},"VitalCheckResponse_InsurancePrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/InsurancePrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[InsurancePrediction]"},"VitalCheckResponse_LifeExpectancyPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/LifeExpectancyPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[LifeExpectancyPrediction]"},"VitalCheckResponse_SleepPrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/SleepPrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[SleepPrediction]"},"VitalCheckResponse_StrokePrediction_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"request_id":{"type":"string","title":"Request Id"},"model_version":{"type":"string","title":"Model Version","default":"1.0.0"},"prediction":{"$ref":"#/components/schemas/StrokePrediction"},"metadata":{"$ref":"#/components/schemas/ResponseMetadata"}},"type":"object","required":["prediction","metadata"],"title":"VitalCheckResponse[StrokePrediction]"}}}}