Risk Engine

POST https://models.dacadoo.com/risk/2

Request

Field Required Description Min Max
years Yes The number years for which to predict risks. 1 15
mhm Yes The metric health model input. See table below.
smk No The smoking input. See table below.
mvm No The movement input. See table below.
slp No The sleep input. See table below.
nut No The nutrition input. See table below.
qlm No The quality of life input. See table below.
clip No Whether to clip out-of-bounds values instead of returning an error status.

Metric Health Model

Biometric data. The eth value must only be used in compliance with applicable regulation.

Field Required Description Min Max
age Yes Age in years [years] 17 86
sex Yes Male = 1 Female = 0 [.] 0 1
hgt Yes Height [cm] 85 215
wgt Yes Weight [kg] 35 165
eth Race/ethnicity [ see below ]
   ethnicity codes:

      0	=>	Not specified
      1	=>	White caucasian
      2	=>	European
      3	=>	African American
      4	=>	American Hispanic
      5	=>	Asian
      6	=>	Chinese
      7	=>	Japanese
      8	=>	Korean
      9	=>	Skandinavian
      10	=>	Southern European
      11	=>	Middle-eastern, Arab
      12	=>	Middle-eastern, non-Arab
      13	=>	Pacific Islander
      14	=>	Pakistani
      15	=>	Indian
      16	=>	Black African
      17	=>	Bangaladeshi
      18	=>	Maori
      19	=>	Aboriginal
      30	=>	Other
0 30
fat Body fat % [%] 6 45
wst Waist circumference [cm] 75 130
tsc Total serum cholesterol [mmol/L] 1.5 18
hdl High-density lipoprotein [mmol/L] 0.2 5.1
ldl Low-density lipoprotein [mmol/L] 0.5 10
tgl Triglycerides [mmol/L] 0.2 40.5
fbg Fasting blood glucose [mmol/L] 4 18
sbp Systolic blood pressure [mmHg] 80 210
dbp Diastolic blood pressure [mmHg] 50 120
map Mean arterial blood pressure [mmHg] 65 170
ppr Pulse pressure [mmHg] 15 175
rhr Resting heart rate [bpm] 40 110
hrr1 One-minute heart rate recovery [bpm] 0 40
crp C-reactive protein [nmol/L] 0.2 60
A1C Glycated hemoglobin [%] 4.4 7.5
alb Serum albumin [g/L] 30 50
eag Estimated average glucose [mmol/L] 4 18
cre Serum creatinine [umol/L (micro-mol)] 30 260
acr Albumin-creatinine ratio [mg/mmol] 30 50
gfr Glomerular filtration rate [mL/min/1.73 m^2] 0 160
cys Serum Cystatin-C [mg/L] 0 6
apoA Apolipoprotein A-1 [g/L] 1.2 1.8
apoB Apolipoprotein B-100 [g/L] 0.8 1.3
adi Adiponectin [ug/mL] 0.01 18
fib Fibrinogen [g/L] 2.5 3.9
fvc Forced Vital capacity [L] 1 6
fev Forced expiratory volume (1 sec) [L] 1 6
hcy Plasma Homocysteine [umol/L] 6 17
ins Serum insulin [pmol/L] 10 1000
bun Blood urea nitrogen [mmol/L] 0.5 30
sun Serum urea nitrogen [mmol/L] 0.5 30
cac Coronary Artery Calcium score [HU] 0 1001
pot Serum Potassium [mmol/L] 2 6.5
pdm Pre-diabetes / IGT [.] 0 1
tpnI Troponin I [ug/L] 0 0.03
tpnT Troponin T [ug/L] 0 0.03
msy Metabolic Syndrome [.] 0 1
abi Ankle-Brachial index [.] 0.2 1.7
whr Waist to hip ratio [.] 0.6 1.3
qtc Bazett-corrected QTc interval [ms] 350 500
alt Alanine aminotransferase [units/L] 1 486
asp Aspartate aminotransferase [units/L] 5 517
ggt gamma-Glutamyltransferase [units/L] 0 1342
hgn Hemoglobin (whole blood) [g/L] 120 210
trl Triglyceride-rich lipoprotein [mmol/L] 0 3
cpt C-peptide [nmol/L] 0 15
exl Self-reported exercise level [.] 0 4
alc Alcohol daily intake [EtOH g/day] 0 70
cof Cups of coffee per day [number] 0 10
cst Corticosteroid usage 0 1
stn Statin usage 0 1
LVH ECG diagnosed left ventricular hypertrophy 0 1
DM2 Diagnosed with Type II Diabetes melitus 0 1
TDM Currently in treatment for diabetes 0 1
HTN Diagnosed with hypertension or SBP >= 160 DBP >= 100 0 1
THT Currently in treatment for hypertension 0 1
AFN Diagnosed with any kind of arrhythmia 0 1
CKD Diagnosed with Chronic Kidney Disease 0 1
PAD Diagnosed with Peripheral Arterial Disease 0 1
STK Has had a stroke 0 1
PMI Has had an MI 0 1
CVD Diagnosed with cardiovascular disease 0 1
CHF Diagnosed Congestive Hear Failure 0 1
PRA Diagnosed with proteinuria / albuminuria 0 1
ANM Diagnosed with anemia 0 1
CNR Has or has had cancer 0 1
COT Cancer outcome: 0 => complete remission, 1 => partial remission, 2 => in treatment 0 1
OSA Has Obstructive Sleep Apnea 0 1
COP Has Chronic Obstructive Pulmonary Disease (COPD) 0 1
STH Has asthma 0 1
VDS Valvular disease (all) 0 1
CHD Coronary heart disease 0 1
fCV Immediate family history of premature CVD (at age < 60) 0 1
fDM Immediate family history of Diabetes 0 1
fMI Immediate family history of angina or heart attack 0 1
fCR Immediate family history of cancer 0 1
nCR Number of family members that have had cancer 1 10
pHT Parental hypertension: 0 (none), (1) one parent, (2) both 0 2
hrM Maximum heart rate 100 195

Smoking

Field Required Description Min Max
now Currently a smoker; 0 = no, 1 = yes 0 1
evr Was a smoker at some point; 0 = no, 1 = yes 0 1
pri Primary smoking product; 1 = cigs, 2 = cigar, 3 = pipe, 4 = smokless/chewing 1 4
yrs Years smoked [years] 0 11
num Number per day [.] 0 30
qit Years since quitting [years] 0 11

Movement

Energy transfer from physical activity, provided as a time series of up to 60 days with array index 0 representing today, index 1 representing yesterday, etc. Use null for gaps. A pre-aggregated mean value can be provided at index 0.

Field Required Description Min Max
nrg normenergy in MET h 0

Sleep

Sleep, provided as a time series of up to 60 days with array index 0 representing today, array index 1 representing yesterday, etc. Use null for gaps. Pre-aggregated mean values can be provided at index 0.

Field Required Description Min Max
bed Time in bed, in hours 0
slp Time asleep, in hours 0
awk Times awoken 0

Nutrition

Nutrition profile, represented as a series of questions with array indexes as per the table below. These questions are best asked with a slider, where a value of 0 indicates never, and a value of 1 indicates all the time. Use null for gaps due to unanswered questions.

Field Required Description Min Max
nqs 0 1
Index Over the past two weeks, how often did you...
0 eat less than 2 servings of fruit a day
1 eat less than 1 serving of peanuts or peanut butter, other nuts, nut butters, and seeds a day
2 eat less than 2 servings of dark leafy green vegetables or other types of vegetables
3 eat less than 2 servings of legumes a week
4 prefer whole grain breads, pasta, or cereal instead of refined breads, pasta, or cereal
5 prefer fish that was neither fried nor breaded instead of red or processed meat
6 eat more than 2 servings of fried or breaded foods a week
7 prefer olive, canola, high oleic safflower, [...] instead of other oils or fats for cooking
8 eat candy bars, pastries, cookies, cakes, or frozen desserts (ice cream) more than twice a day
9 limit your salt intake by reducing [...] the salt content of processed foods
10 drink more than 6 glasses of water or other unsweetened beverages a day
11 drink 2 glasses or more of sugar-sweetened beverages a day
12 drink more than 1 serving of alcohol a day
13 take a moment before you ate to appreciate the colors and smells of your food
14 eat more than 3 servings of processed foods a week
15 eat at least two main meals a day
16 snack without noticing that you were eating
17 eat 3 or more meals a week from a fast food restaurant
18 stop eating when you were full even when eating something you love
19 recognize when food advertisements made you want to eat
20 go find something to eat when you were feeling stressed
21 skip breakfast and eat your first main meal at lunchtime

Quality of Life

These questions are best asked with a slider, where a value of 0 indicates not at all, and a value of 1 indicates very much so.

Field Required Description Min Max
q01 Do you feel you are in good health? 0 1
q02 Are you satisfied with your state of health? 0 1
q03 How often are you in physical or emotional pain? 0 1
q04 Does pain interfere with your enjoyment of life? 0 1
q05 Does your physical health interfere with your daily activities? 0 1
q06 Does your emotional health interfere with your daily activities? 0 1
q07 Do you feel hopeful about the future? 0 1
q08 Do you feel anxious or under stress? 0 1
q09 (Currently not used) 0 1
q10 Do you enjoy eating? 0 1
q11 Do you feel full of energy? 0 1
q12 Do you feel sad or depressed? 0 1
q13 Do you feel calm and relaxed? 0 1
q14 Do you feel that your efforts are fully appreciated? 0 1
q15 Do you feel good about your life in general? 0 1
q16 Do you feel good about your social interactions? 0 1
q17 Do you feel good about yourself? 0 1
q18 Do you feel good about your financial situation? 0 1
q19 Do you feel good about the quality of your sleep? 0 1
q20 Do you feel good about your work? 0 1
q21 Do you exercise regularly? 0 1
q22 Do you keep a healthy diet? 0 1
q23 (Currently not used) 0 1
q24 Do you think your physical health will improve in the near future? 0 1
q25 Do you think your emotional health will improve in the near future? 0 1
q26 Do you think the overall quality of your life will improve in the near future? 0 1
q27 Do you think your outlook on life will improve in the near future? 0 1

Response

Field Guaranteed Description Min Max
years Yes The number years for which risks have been predicted. 1 30
risks Yes The predicted risks. See table below.
mhm Yes The metric health model output, including imputed values. See table above.
clip Yes Whether out-of-bounds values would have been clipped instead of returning an error status.

Risks

Condition-based mortality and morbidity risks, specifically:

Field Guaranteed Description Min Max
condition Yes The underlying condition of the risk. See enumeration above.
type Yes Whether the risk is for mortality or morbidity.
abs Yes The absolute, global probability. 0 1

Examples

Request Body

{
  "years": 10,
  "mhm": {
    "age": 40,
    "hgt": 180,
    "sex": 1,
    "wgt": 70
  },
  "smk": {
    "now": 0,
    "evr": 0
  },
  "mvm": {
    "nrg": [ 6.5 ]
  },
  "nut": {
    "nqs": [ null, null, null, 0.1, 0.9 ]
  },
  "qlm": {
    "q01": 0.9
  },
  "clip": false
}

Response Body

{
  "years": 10,
  "risks": [
    {
      "condition": "all-cause",
      "type": "mortality",
      "abs": 0.0217
    },
    {
      "condition": "cardiovascular-disease",
      "type": "mortality",
      "abs": 0.0072
    },
    {
      "condition": "cancer",
      "type": "mortality",
      "abs": 0.0116
    },
    {
      "condition": "type-2-diabetes",
      "type": "morbidity",
      "abs": 0.0323
    },
    {
      "condition": "hypertension",
      "type": "morbidity",
      "abs": 0.0666
    },
    {
      "condition": "metabolic-dysfunction",
      "type": "morbidity",
      "abs": 0.0869
    }
  ],
  "mhm": {
    "note": "66 values redacted in evaluation mode.",
    "dbp": 81.4000,
    "sbp": 128.0804,
    "fbg": 5.5255
  },
  "clip": false
}