Risk Engine

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

Request

Field Required Description Min Max
mhm Yes The metric health model input. See table below.
smk No The smoking 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; the implementation is partial at this time. ICD-10 codes are provided where applicable. Data can by any combination of imputed (derived from other values), imputation (used to derive other values), or prediction (used to predict some risk) as given by the Use column.

Field Required Description Min Max ICD-10 Use
age Yes Age in years [years] 17 90 imputation, prediction
sex Yes Male = 1 Female = 0 [.] 0 1 imputation, prediction
hgt Yes Height [cm] 85 215 imputation, prediction
wgt Yes Weight [kg] 35 165 imputation, prediction
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 imputation, prediction
a1c Glycated hemoglobin [%] 4 12.5 imputation, imputed, prediction
abi Ankle-Brachial index [.] 0.2 1.7 imputed
acr Albumin-creatinine (urine) ratio [mg/mmol] 0.1 100 imputed
adi Adiponectin [ug/mL] 0.01 18 imputed
alb Serum albumin [g/L] 5 80 imputed
alt Alanine aminotransferase [units/L] 1 486 imputed
apoA Apolipoprotein A-1 [g/L] 1.2 1.8 imputed
apoB Apolipoprotein B-100 [g/L] 0.8 1.3 imputed
asp Aspartate aminotransferase [units/L] 5 517 imputed
bun Blood urea nitrogen [mmol/L] 0.5 30 imputed
cac Coronary Artery Calcium score [HU] 0 1001 imputed
cal Serum calcium [nmol/L] 1 4 imputed
cpt C-Peptide [nmol/L] 0.02 15 imputed
cre Serum creatinine [umol/L (micro-mol)] 0 1600 imputation, imputed, prediction
crp C-reactive protein [nmol/L] 25 2400 imputed, prediction
cys Serum Cystatin-C [mg/L] 0 6 imputed
dbp Diastolic blood pressure [mmHg] 50 120 imputation, imputed, prediction
eag Estimated average glucose [mmol/L] 4 18 imputed
fat Body fat % [%] 6 45 imputation, imputed, prediction
fbg Fasting blood glucose [mmol/L] 4 18 imputation, imputed, prediction
fev Forced expiratory volume (1 sec) [L] 1 6 imputed
fib Fibrinogen [g/L] 2.5 3.9 imputed
fvc Forced Vital capacity [L] 1 6 imputed
gfr Glomerular filtration rate [mL/min/1.73 m^2] 0 160 imputed
ggt gamma-Glutamyltransferase [units/L] 0 1342 imputed
hcy Plasma Homocysteine [umol/L] 1 140 imputed
hdl High-density lipoprotein [mmol/L] 0.2 5.1 imputation, imputed, prediction
hgn Hemoglobin (whole blood) [g/L] 120 210 imputed
ins Serum insulin [pmol/L] 10 1000 imputed
ldl Low-density lipoprotein [mmol/L] 0.5 10 imputed, prediction
map Mean arterial blood pressure [mmHg] 65 170 imputed
msy Metabolic Syndrome [.] 0 1 imputed
pdm Pre-diabetes / IGT [.] 0 1 imputation, imputed
pot Serum Potassium [mmol/L] 2 6.5 imputed
ppr Pulse pressure [mmHg] 15 175 imputed
qtc Bazett-corrected QTc interval [ms] 350 500 imputed
rhr Resting heart rate [bpm] 40 130 imputation, imputed
sbp Systolic blood pressure [mmHg] 80 210 imputation, imputed, prediction
sfe Serum iron [umol/L] 0 85 imputed
sod Serum sodium [nmol/L] 90 200 imputed
tgl Triglycerides [mmol/L] 0.2 40.5 imputation, imputed, prediction
tsc Total serum cholesterol [mmol/L] 1.5 18 imputation, imputed, prediction
whr Waist to hip ratio [.] 0.6 1.3 imputed
wst Waist circumference [cm] 75 130 imputation, imputed, prediction
exl Self-reported exercise level [.] 0 4 imputed
alc Alcohol daily intake [EtOH g/day] 0 70 imputation, imputed, prediction
cof Cups of coffee per day [number] 0 10 imputed
cst Corticosteroid usage 0 1 imputed
AFN Diagnosed with any kind of arrhythmia 0 1 I49.9 imputed
ANM Diagnosed with anemia 0 1 D64.9 imputed
CHD Coronary heart disease 0 1 I20~I25 imputed
CHF Diagnosed Heart Failure 0 1 I50.9 imputed
CKD Diagnosed with Chronic Kidney Disease 0 1 N17~N19 imputed
CVD Diagnosed with cardiovascular disease 0 1 I25 imputed
DM2 Diagnosed with Type II Diabetes melitus 0 1 E10~E14 imputation, imputed, prediction
HTN Diagnosed with hypertension or SBP >= 160 DBP >= 100 0 1 I10 imputation, imputed, prediction
LVH ECG diagnosed left ventricular hypertrophy 0 1 I51.7 imputed, prediction
PAD Diagnosed with Peripheral Arterial Disease 0 1 I73 imputed
PMI Has had an MI 0 1 I21.9 imputation, imputed, prediction
PRA Diagnosed with proteinuria / albuminuria 0 1 R80.9 imputed
TDM Currently in treatment for diabetes 0 1 imputation, prediction
THT Currently in treatment for hypertension 0 1 imputation, prediction
VDS Valvular disease (all) 0 1 I05~I08 imputed
fCV Immediate family history of premature CVD (at age < 60) 0 1 Z82.4 imputed, prediction
fDM Immediate family history of Diabetes 0 1 Z83.3 imputed, prediction
fMI Immediate family history of angina or heart attack 0 1 Z82.49 imputed, prediction
pHT Parental hypertension: 0 (none), (1) one parent, (2) both 0 2 Z82.4 imputed
hrM Maximum heart rate 100 195 imputed

Smoking

Smoking history and status. Please see above for an explanation of the Use column.

Field Required Description Min Max Use
now Currently a smoker; 0 = no, 1 = yes 0 1 imputation, imputed, prediction
evr Was a smoker at some point; 0 = no, 1 = yes 0 1 imputation, imputed, prediction
num Number per day [.] 0 30 imputed, prediction

Response

Field Guaranteed Description Min Max
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:

Some fields are based on a reference population and related stratification. The reference population is prepared individually using customer-supplied data on a sufficient number of lives, and using an agreed stratification for the business case. In evaluation mode, a proxy reference population stratified by age and sex is used.

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.
index Yes The risk index. A relative measure of risk (0 to 100) based on worldwide data. Higher values imply higher risk. 0 100
ratio Yes The risk ratio. A relative measure of risk (0 to infinity) based on a reference population. It is defined as the ratio of the individual risk index to the mean risk index of the reference population. 0
zscore Yes The risk z-score. A relative measure of risk (-infinity to +infinity) based on a reference population as above. It is defined as the difference of the individual risk index and the mean risk index of the reference population with the difference then divided by the standard deviation of the risk index of the reference population.
percentile Yes The risk percentile. A relative measure of risk (0 to 100), derived from the z-score and thus based on a reference population. It assumes the fiction of a normal distirbution of risk indexes. 0 100

Examples

Request Body

{
  "years": 10,
  "mhm": {
    "age": 45,
    "hgt": 178,
    "wgt": 95,
    "sex": 0
  },
  "clip": false
}

Response Body

{
  "clip":false,
  "risks": [
    {
      "condition": "all-cause",
      "type": "mortality",
      "index": 3.79,
      "ratio": 0.944,
      "zscore": -1.037,
      "percentile": 14.99
    },
    {
      "condition": "cardiovascular-disease",
      "type": "mortality",
      "index": 1.17,
      "ratio": 0.977,
      "zscore": -0.233,
      "percentile": 40.78
    },
    {
      "condition": "cancer",
      "type": "mortality",
      "index": 2.8,
      "ratio": 1.001,
      "zscore": 0.018,
      "percentile": 50.72
    },
    {
      "condition": "type-2-diabetes",
      "type": "morbidity",
      "index": 1.07,
      "ratio": 0.997,
      "zscore": -0.021,
      "percentile": 49.16
    },
    {
      "condition": "hypertension",
      "type": "morbidity",
      "index": 0.94,
      "ratio": 1.007,
      "zscore": 0.058,
      "percentile": 52.32
    }
  ],
  "mhm":{
    "note":"63 values redacted in evaluation mode",
    "fbg": 5.3,
    "dbp": 80.4,
    "sbp": 127
  }
}