Health Score

POST https://models-nl.dacadoo.com/score/1.6.0

Request

Field Required Description
control No The control input. See table below.
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.
preg No The pregnancy input. See table below.
clip No If true, clips out-of-bounds values instead of returning an error status; if false, returns an error status if a value is out-bounds as to the documented limits and an additional margin of tolerance.

Data values are used to calculate some score; not all data values affect the overall Health Score.

Control

Control parameters. These parameters control aspects of certain estimations in the engine, and provide feedback on control paths taken (on output).

Field Required Description Min Max
conf_level Confidence level (default 0.95). Used both for confidence intervals and interview guidance. 0.5 1
conf_onesided Confidence interval one-sided = 1, two-sided = 0 (default) 0 1
inter_endpoint Desired endpoint for interview guidance [ see below ]
	inter_endpoint codes:

	   0  =>  Health Score.
0 0
qlm_version Quality of life questionnaires used (either 2014 or 2021). Output only.
mfs_version Mindfulness score used (either 2014 or 2021). Output only.
shap_endpoint Desired endpoint for SHAP [ see below ]
	shap_endpoint codes:

	   0  =>  Health Score.
0 0
shap_ref Flag to select reference population [ see below ]
      shap_ref codes:

         0  =>  Self-contained: SHAP values are computed comparing to required information (default).
         1  =>  Average NHANES.
         2  =>  Best 25% from NHANES.
0 2
min_entries_ts Minimum entries required in a time-series to be considered (default 1) 1 70

Metric Health Model

Health data. ICD-10 codes are provided where applicable. They cover the broad definition used in the underlying research.

Field Required Description Min Max ICD-10
age Yes Age in years [years] 17 90
sex Yes Male = 1 Female = 0 [.] 0 1
hgt Yes Height [cm] 85 215
wgt Yes Weight [kg] 35 165
a1c Glycated hemoglobin [%] 3.5 10.5
acr Albumin-creatinine (urine) ratio [mg/mmol] 0 100
cre Serum creatinine [umol/L (micro-mol)] 20 180
crp High-sensitivity C-reactive protein [mg/L] 0.1 10
cys Serum Cystatin-C [mg/L] 0 2.5
dbp Diastolic blood pressure [mmHg] 40 120
eag Estimated average glucose [mmol/L] 3 14
fat Body fat % [%] 6 55
fbg Fasting blood glucose [mmol/L] 3 14
gfr Glomerular filtration rate [mL/min/1.73 m^2] 18 180
hdl High-density lipoprotein [mmol/L] 0.5 3
ldl Low-density lipoprotein [mmol/L] 1 7
map Mean arterial blood pressure [mmHg] 50 130
PDM Pre-diabetes / IGT [.] 0 1
ppr Pulse pressure [mmHg] 20 125
rhr Resting heart rate [bpm] 35 120
sbp Systolic blood pressure [mmHg] 80 190
spo2 Blood Oxygen Saturation (SpO2) [%] 92 100
tgl Triglycerides [mmol/L] 0.2 6.5
tsc Total serum cholesterol [mmol/L] 2 10
vdl Very low density lipoprotein [mmol/L] 0.1 2.8
vo2max Maximal aerobic capacity (VO2max) [mL/kg/min] 16.8 59.8
whr Waist to hip ratio [.] 0.6 1.2
wst Waist circumference [cm] 50 150
exh Self-reported exercise hours per week [hrs/week] 0 21
alc Alcohol daily intake [EtOH g/day] 0 70
cof Cups of coffee per day [number/day] 0 6
cst Corticosteroid usage 0 1
CKD Diagnosed with Chronic Kidney Disease 0 1 N18
DM2 Diagnosed with diabetes mellitus 0 1 E10-E14
HTN Diagnosed with arterial hypertension or SBP >= 140 DBP >= 90 0 1 I10-I13,I15
LVH Diagnosed with left ventricular hypertrophy 0 1 I51.7
PMI Has had an MI 0 1 I21-I22
TDM Currently in treatment for diabetes 0 1
THT Currently in treatment for hypertension 0 1
fCV Immediate family history of premature heart disease or stroke (at age < 60) 0 1
fDM Immediate family history of diabetes 0 1
fMI Immediate family history of premature angina or heart attack (at age < 60) 0 1
pHT Parental hypertension: 0 (none), (1) one parent, (2) both 0 2

Smoking

Smoking history and status.

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
yrs Years smoked [years] 0 80
num Number per day [.] 0 30
qit Years since quitting [years] 0 80
slt Current use of smokeless tobacco; 0 = no, 1 = yes 0 1

Movement

Energy transfer from physical activity, represented as time series up to 70 days with array index 0 being today. Use null for gaps where the quantity is unknown. A proprietary aggregation is applied to the series. To control the aggregation externally, fill in index 0 only. In case that the time series is empty, the variable exh is used instead.

Field Required Description Min Max
nrg normenergy in MET h 0

Sleep

Sleep, represented as three time series (time asleep, time in bed and times awoken) up to 70 days with array index 0 being today. Use null for gaps where the quantity is unknown. A proprietary aggregation is applied to the series. To control the aggregation externally, fill in index 0 only. Note that for a night to be considered, time asleep must be provided. If no valid night is provided, the average sleep time slp_avg is used instead.

Field Required Description Min Max Time series
bed Time in bed, in hours 0 Yes
slp Time asleep, in hours 0 Yes
awk Times awoken 0 Yes
slp_avg Average sleeping time, in hours 0

Nutrition

Nutrition questions. These questions are meant to be answered with a slider ranging from never (0) to all the time (1). The questions denoted as Starter must all be answered for the input to be considered.

Field Required Description Min Max Starter
nqs01 ... eat less than 2 servings of fruit a day? 0 1 Yes
nqs02 ... eat less than 1 serving of peanuts or peanut butter, other nuts, nut butters, and seeds a day? 0 1 Yes
nqs03 ... eat less than 2 servings of dark leafy green vegetables or other types of vegetables? 0 1 Yes
nqs04 ... eat less than 2 servings of legumes a week? 0 1
nqs05 ... prefer whole grain breads, pasta, or cereal instead of refined breads, pasta, or cereal? 0 1 Yes
nqs06 ... prefer fish that was neither fried nor breaded instead of red or processed meat? 0 1
nqs07 ... eat more than 2 servings of fried or breaded foods a week? 0 1
nqs08 ... prefer olive, canola, high oleic safflower, [...] instead of other oils or fats for cooking? 0 1
nqs09 ... eat candy bars, pastries, cookies, cakes, or frozen desserts (ice cream) more than twice a day? 0 1
nqs10 ... limit your salt intake by reducing [...] the salt content of processed foods? 0 1
nqs11 ... drink more than 6 glasses of water or other unsweetened beverages a day? 0 1
nqs12 ... drink 2 glasses or more of sugar-sweetened beverages a day? 0 1 Yes
nqs13 ... drink more than 1 serving of alcohol a day? 0 1
nqs14 ... take a moment before you ate to appreciate the colors and smells of your food? 0 1
nqs15 ... eat more than 3 servings of processed foods a week? 0 1
nqs16 ... eat at least two main meals a day? 0 1 Yes
nqs17 ... snack without noticing that you were eating? 0 1 Yes
nqs18 ... eat 3 or more meals a week from a fast food restaurant? 0 1
nqs19 ... stop eating when you were full even when eating something you love? 0 1
nqs20 ... recognize when food advertisements made you want to eat? 0 1
nqs21 ... go find something to eat when you were feeling stressed? 0 1
nqs22 ... skip breakfast and eat your first main meal at lunchtime? 0 1

Quality of Life

Psychometric questions. These inputs relate to multiple questionnaires and are meant to be answered with a slider as follows:

Prefix Designation Status Preamble Slider
q Quality of Life (2014) Superseded by GAD-7, PHQ-9, PSS-10, GSRH and MAAS None not at all (0) to very much so (1)
gad General Anxiety Disorder-7 (GAD-7)1 Current Over the last two weeks, how often have you been bothered by the following problems ... not at all (0) to nearly every day (1)
phq Patient Health Questionnaire-9 (PHQ-9)2 Current Over the last two weeks, how often have you been bothered by the following problems ... not at all (0) to nearly every day (1)
pss Perceived Stress Scale (PSS-10)3 Current In the last month, how often have you ... never (0) to very often (1)
gsrh General Self-Related Health Current None poor health (0) to excellent health (1)
maas Mindful Attention and Awareness Scale (MAAS)4 Current None almost never (0) to almost always (1)

References:

  1. From "A Brief Measure for Assessing Generalized Anxiety Disorder: The GAD-7" by Spitzer RL, Kroenke K, Williams JBW, Löwe B, Arch Intern Med., 2006, doi:10.1001/archinte.166.10.1092.
  2. From "The PHQ-9: validity of a brief depression severity measure" by Kroenke K, Spitzer RL, Williams JB, J Gen Intern Med., 2001, 10.1046/j.1525-1497.2001.016009606.x.
  3. From "Perceived stress in a probability sample of the United States" by Cohen S, Williamson G, Spacapan S, Oskamp S, The social psychology of health., 1988, doi.org/10.21961/mdm:24503, Reprinted with permission.
  4. From "The benefits of being present: Mindfulness and its role in psychological well-being" by Brown KW, Ryan RM, Journal of Personality and Social Psychology, 2003, doi:10.1037/0022-3514.84.4.822, Reprinted with permission.

The superseded Quality of Life (2014) model is used if and only if at least one of its inputs is provided and none of the GAD, PHQ, PSS or GSRH (2021) model inputs are provided. In all other cases, including no input at all, the 2021 model is used. When a transition from the 2014 model to the 2021 model takes place, it should be for as many inputs as possible at once, as the 2014 inputs are no longer used once a single 2021 input is provided. The control structure (see table above) indicates on output which model was used.

For backwards compatibility, if and only if at least one input of the superseded Quality of Life (2014) model and no input of the MAAS (2021) model is provided, the mindfulness subscore is equal to the wellbeing subscore from the Quality of Life (2014) model. In any other case, the new MAAS questionnaire is used to compute the mindfulness subscore. The control structure (see table above) indicates on output which model was used.

Mindful activity is represented as time series up to 70 days with array index 0 being today. Use null for gaps where the quantity is unknown. A proprietary aggregation is applied to the series. To control the aggregation externally, fill in index 0 only. Mindful activity is not compatible with the superseded Quality of Life (2014) model.

Note that SHAP values are not supported when working with the old questionnaire.

Field Required Description Min Max Time series
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
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
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
gad01 ... feeling nervous, anxious, or on edge? 0 1
gad02 ... feeling you are unable to stop or control worrying? 0 1
gad03 ... feeling you worry too much about different things? 0 1
gad04 ... having trouble relaxing? 0 1
gad05 ... feeling so restless that it is hard to sit still? 0 1
gad06 ... becoming annoyed or irritated? 0 1
gad07 ... feeling afraid of something awful happening? 0 1
phq01 ... little interest or pleasure in doing things? 0 1
phq02 ... feeling down, depressed, or hopeless? 0 1
phq03 ... trouble falling or staying asleep, or sleeping too much? 0 1
phq04 ... feeling tired or having little energy? 0 1
phq05 ... poor appetite or overeating? 0 1
phq06 ... feeling bad about yourself, or that you are a failure or have let yourself or your family down? 0 1
phq07 ... trouble concentrating on things, such as watching television? 0 1
phq08 ... moving or speaking so slowly that other people could have noticed or being so fidgety or restless that you have been moving around a lot more than usual? 0 1
phq09 ... thoughts that you would be better off dead or of hurting yourself in some way? 0 1
pss01 ... been upset because of something that happened unexpectedly? 0 1
pss02 ... felt that you were unable to control the important things in your life? 0 1
pss03 ... felt nervous and stressed? 0 1
pss04 ... felt confident about your ability to handle your personal problems? 0 1
pss05 ... felt that things were going your way? 0 1
pss06 ... found that you could not cope with all the things that you had to do? 0 1
pss07 ... been able to control irritations in your life? 0 1
pss08 ... felt that you were on top of things? 0 1
pss09 ... been angered because of things that happened that were outside of your control? 0 1
pss10 ... felt difficulties were piling up so high that you could not overcome them? 0 1
gsrh How would you rate your health? 0 = poor health, 1 = excellent health 0 1
maas01 I could be experiencing some emotion and not be conscious of it until some time later. 0 1
maas02 I break or spill things because of carelessness, not paying attention, or thinking of something else. 0 1
maas03 I find it difficult to stay focused on what’s happening in the present. 0 1
maas04 I tend to walk quickly to get where I’m going without paying attention to what I experience along the way. 0 1
maas05 I tend not to notice feelings of physical tension or discomfort until they really grab my attention. 0 1
maas06 I forget a person’s name almost as soon as I’ve been told it for the first time. 0 1
maas07 It seems I am “running on automatic” without much awareness of what I'm doing. 0 1
maas08 I rush through activities without being really attentive to them. 0 1
maas09 I get so focused on the goal I want to achieve that I lose touch with what I am doing right now to get there. 0 1
maas10 I do jobs or tasks automatically, without being aware of what I’m doing. 0 1
maas11 I find myself listening to someone with one ear, doing something else at the same time. 0 1
maas12 I drive places on “automatic pilot” and then wonder why I went there. 0 1
maas13 I find myself preoccupied with the future or the past. 0 1
maas14 I find myself doing things without paying attention. 0 1
maas15 I snack without being aware that I’m eating. 0 1
mfm Tracked mindful activity [min] 0 60 Yes

Pregnancy

Pregnancy related inputs for score adjustments.

Field Required Description Min Max
wgt_week Pregnancy week when wgt was last measured 0 57
prewgt Pre-pregnancy weight [kg] 35 165
dbp_week Pregnancy week when dbp was last measured 0 57
hdl_week Pregnancy week when hdl was last measured 0 57
ldl_week Pregnancy week when ldl was last measured 0 57
rhr_week Pregnancy week when rhr was last measured 0 57
sbp_week Pregnancy week when sbp was last measured 0 57
tgl_week Pregnancy week when tgl was last measured 0 57
tsc_week Pregnancy week when tsc was last measured 0 57
end_week End of pregnancy week 0 45

Response

Field Guaranteed Description Min Max
control Yes The control output. See table above.
scr Yes Overall Health Score 0 1,000
rqy Yes Relative quality years gained/lost
components Yes Components. See table below.
subscores Yes Subscores. See table below.
inter No The interview guidance output. See table below.
shap No SHAP values. See table below.
clip Yes Whether out-of-bounds values would have been clipped instead of returning an error status.
version Yes The endpoint version.

Components

The components are the principal three pilars of the Health Score.

Field Guaranteed Description Min Max
lfs Yes Lifestyle score 0 1,000
bdy Yes Body score 0 1,000
fee Yes Feeling score 0 1,000

Subscores

Subscores place a spot light on selected areas of health. For consistency, higher scores are better. Consequently, a score such as the stress score should regarded as an anti-stress score.

Field Guaranteed Description Min Max
mvm Yes Movement score 0 1,000
nut Yes Nutrition score 0 1,000
smk Yes (Anti-) Smoking score 0 1,000
obe Yes (Anti-) Obsesity score 0 1,000
slp Yes Sleep score 0 1,000
dep Yes (Anti-) Depression score 0 1,000
wel Yes Wellness score 0 1,000
str Yes (Anti-) Stress score 0 1,000
ind Yes Indulgences score 0 1,000
mfs Yes Mindfulness score 0 1,000
anx Yes (Anti-) Anxiety score 0 1,000

Interview Guidance

Interview guidance uncertainties of the score. Uncertainties are provided as per the table below for groups of inputs as well as overall. Each uncertainty is represented as an array with the lowest and highest score value of the chosen endpoint, in that order. For continuous variables, these values are based on the confidence intervals of imputations of missing inputs, at the specified confidence level (see Control above). If an input group is fully provided, there is no uncertainty, and the two values are identical and correspond to the estimated score value. Otherwise, there may be a difference between the two values. An interview implementation may consider that difference as the remaining uncertainty for the input group, and prefer input groups with a large difference.

Field Description
uncertainty Overall uncertainty of the estimation
group01
  • smk.now
  • smk.evr
  • smk.num
  • smk.qit
  • smk.yrs
group02
  • mhm.DM2
  • mhm.TDM
group03
  • mhm.HTN
  • mhm.THT
group04
  • mhm.PMI
group05
  • mhm.LVH
group06
  • mhm.fCV
group07
  • mhm.fDM
group08
  • mhm.fMI
group09
  • mhm.pHT
group10
  • mhm.sbp
  • mhm.dbp
group11
  • mhm.fbg
group12
  • mhm.a1c
group13
  • mhm.tsc
  • mhm.hdl
  • mhm.tgl
  • mhm.ldl
group14
  • mhm.wst
group15
  • mhm.fat
group16
  • mhm.rhr
group17
  • mhm.cre
group18
  • mhm.whr
group19
  • mhm.cst
group20
  • mhm.CKD
group21
  • smk.slt
group22
  • mhm.acr
group23
  • mhm.crp
group24
  • mhm.cys
group25
  • mhm.eag
group26
  • mhm.gfr
group27
  • mhm.PDM
group28
  • mhm.CVD
group29
  • mhm.DYS
group30
  • mhm.SPT
group31
  • mhm.STH
group32
  • mhm.vo2max

SHAP values

SHAP values of the Health Score. SHAP values are grouped as per the table below.

Field Description
average Reference point
age
  • mhm.age
sex
  • mhm.sex
bmi
  • mhm.hgt
  • mhm.wgt
a1c
  • mhm.a1c
  • mhm.eag
cre
  • mhm.cre
crp
  • mhm.crp
bp
  • mhm.dbp
  • mhm.sbp
  • mhm.ppr
  • mhm.map
fat
  • mhm.fat
fbg
  • mhm.fbg
col
  • mhm.tsc
  • mhm.hdl
  • mhm.ldl
  • mhm.vdl
  • mhm.tgl
rhr
  • mhm.rhr
spo2
  • mhm.spo2
whr
  • mhm.whr
wst
  • mhm.wst
cst
  • mhm.cst
PDM
  • mhm.PDM
DM2
  • mhm.DM2
  • mhm.TDM
HTN
  • mhm.HTN
  • mhm.THT
LVH
  • mhm.LVH
PMI
  • mhm.PMI
fCV
  • mhm.fCV
fDM
  • mhm.fDM
fMI
  • mhm.fMI
pHT
  • mhm.pHT
smk
  • smk.now
  • smk.evr
  • smk.qit
  • smk.num
  • smk.yrs
slt
  • smk.slt
STH
  • mhm.STH
SPT
  • mhm.SPT
DYS
  • mhm.DYS
vo2max
  • mhm.vo2max
acr
  • mhm.acr
gfr
  • mhm.gfr
cys
  • mhm.cys
CVD
  • mhm.CVD
CKD
  • mhm.CKD
mvm
  • mvm.nrg
cof
  • mhm.cof
alc
  • mhm.alc
slp
  • slp.slp
  • slp.bed
  • slp.awk
gsrh
  • qlm.gsrh
nut
  • nut.nqs01
  • nut.nqs02
  • nut.nqs03
  • nut.nqs04
  • nut.nqs05
  • nut.nqs06
  • nut.nqs07
  • nut.nqs08
  • nut.nqs09
  • nut.nqs10
  • nut.nqs11
  • nut.nqs12
  • nut.nqs13
  • nut.nqs14
  • nut.nqs15
  • nut.nqs16
  • nut.nqs17
  • nut.nqs18
  • nut.nqs19
  • nut.nqs20
  • nut.nqs21
  • nut.nqs22
gad
  • qlm.gad01
  • qlm.gad02
  • qlm.gad03
  • qlm.gad04
  • qlm.gad05
  • qlm.gad06
  • qlm.gad07
phq
  • qlm.phq01
  • qlm.phq02
  • qlm.phq03
  • qlm.phq04
  • qlm.phq05
  • qlm.phq06
  • qlm.phq07
  • qlm.phq08
  • qlm.phq09
pss
  • qlm.pss01
  • qlm.pss02
  • qlm.pss03
  • qlm.pss04
  • qlm.pss05
  • qlm.pss06
  • qlm.pss07
  • qlm.pss08
  • qlm.pss09
  • qlm.pss10

Examples

Request Body

{
    "mhm": {
        "age": 35,
        "hgt": 173,
        "wgt": 86,
        "sex": 0    
    },
    "smk": {
        "now": 0,
        "evr": 0
    },
    "mvm": {
        "nrg": [ 6.5 ]
    },
    "slp": {
        "bed": [ 8.5 ],
        "slp": [ 7.5 ],
        "awk": [ 2 ]
    },
    "nut": {
        "nqs01": 0.5,
        "nqs02": 0.5,
        "nqs03": 0.5,
        "nqs05": 0.5,
        "nqs12": 0.5,
        "nqs16": 0.5,
        "nqs17": 0.5
    },
    "qlm": {
        "gshr": 0.5
    },
    "preg": {
        "prewgt": 80,
        "wgt_week": 20
    },
    "clip": false
}

Response Body

{
    "control": {
        "min_entries_ts": 1,
        "mfs_version": 2021,
        "conf_level": 0.95,
        "qlm_version": 2021,
        "conf_onesided": 0
    },
    "components": {
        "bdy": 563,
        "fee": 545,
        "lfs": 826
    },
    "scr": 647,
    "rqy": 8.87,
    "subscores": {
        "str": 487,
        "slp": 840,
        "wel": 511,
        "ind": 617,
        "anx": 584,
        "obe": 946,
        "nut": 614,
        "mfs": 500,
        "mvm": 958,
        "smk": 1000,
        "dep": 594
    },
    "clip": false,
    "version": "1.6.0"
}