Reference Data

x-api-key: YOUR_API_KEY

GET /reference-data/ HTTP/1.1
Host: api.voloridgehealth.com
x-api-key: YOUR_API_KEY

[
  {
    "concept_id": 3005168,
    "concept_name": "Iron binding capacity.unsaturated [Mass/volume] in Serum or Plasma",
    "concept_code": "2501-5",
    "pref_ucum_unit": "ug/dL",
    "lookup_type_concept_id": null,
    "vocabulary_id": "LOINC",
    "vocabulary_concept_id": 44819102,
    "concept_class_id": "Lab Test",
    "domain_id": "Measurement",
    "standard_concept": "S",
    "start_dtutc": "1970-01-01 00:00:00",
    "end_dtutc": "2099-12-31 00:00:00",
    "created_dtutc": "2025-11-24 20:55:37.820",
    "updated_dtutc": null
  }
]

POST /predictor-statistics/ HTTP/1.1
Host: api.voloridgehealth.com
x-api-key: YOUR_API_KEY
Content-Type: application/json

{
  "header": {
    "event_id": "a1b2c3d4-0000-0000-0000-000000000001",
    "event_asof_dtutc": "2026-03-02T20:00:00Z"
  },
  "sex": "male",
  "age": 52.0
}

{
  "header": {
    "event_id": "a1b2c3d4-0000-0000-0000-000000000001",
    "event_asof_dtutc": "2026-03-02T20:00:00Z",
    "scoring_version": "4.3.0"
  },
  "predictor_statistics": [
    {
      "name": "Glucose",
      "observation_codes": ["2345-7", "6789-0"],
      "mean": 95.4,
      "optimal_min": 70.0,
      "optimal_max": 99.0,
      "absolute_min": 40.0,
      "absolute_max": 500.0,
      "quest_lab_range": "range",
      "quest_lab_min": 70.0,
      "quest_lab_max": 99.0
    },
    {
      "name": "BMI",
      "observation_codes": ["39156-5"],
      "mean": 27.1,
      "optimal_min": 18.5,
      "optimal_max": 24.9,
      "absolute_min": 10.0,
      "absolute_max": 80.0,
      "quest_lab_range": null,
      "quest_lab_min": null,
      "quest_lab_max": null
    }
  ]
}

{
  "detail": "Error fetching reference data: Connection timeout"
}

GET /top-disease-predictors/ HTTP/1.1
Host: api.voloridgehealth.com
x-api-key: YOUR_API_KEY

{
  "top_disease_predictors": [
    {
      "disease": "MACE3",
      "predictors": [
        { "observation_codes": ["8480-6"], "rank": 1, "strength": 10.0 },
        { "observation_codes": ["33959-8"], "rank": 2, "strength": 10.0 }
      ]
    },
    {
      "disease": "Mortality",
      "predictors": [
        { "observation_codes": ["33959-8"], "rank": 1, "strength": 10.0 },
        { "observation_codes": ["10000-8"], "rank": 2, "strength": 9.0 }
      ]
    }
  ]
}

{
  "detail": "Error fetching reference data: Connection timeout"
}

curl -X GET "https://api.voloridgehealth.com/reference-data/" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.voloridgehealth.com/reference-data/",
    headers={"x-api-key": "YOUR_API_KEY"}
)
response.raise_for_status()
data = response.json()
print(f"Retrieved {len(data)} reference entries.")

const response = await fetch("https://api.voloridgehealth.com/reference-data/", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
if (!response.ok) throw new Error(`API error: ${response.status}`);
const data = await response.json();
console.log(`Retrieved ${data.length} reference entries.`);

curl -X POST "https://api.voloridgehealth.com/predictor-statistics/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "header": {
      "event_id": "a1b2c3d4-0000-0000-0000-000000000001",
      "event_asof_dtutc": "2026-03-02T20:00:00Z"
    },
    "sex": "male",
    "age": 52.0
  }'

import requests

payload = {
    "header": {
        "event_id": "a1b2c3d4-0000-0000-0000-000000000001",
        "event_asof_dtutc": "2026-03-02T20:00:00Z"
    },
    "sex": "male",
    "age": 52.0
}

response = requests.post(
    "https://api.voloridgehealth.com/predictor-statistics/",
    headers={"x-api-key": "YOUR_API_KEY"},
    json=payload
)
response.raise_for_status()
data = response.json()
print(f"Scoring version: {data['header']['scoring_version']}")
print(f"Retrieved stats for {len(data['predictor_statistics'])} predictors.")

const response = await fetch("https://api.voloridgehealth.com/predictor-statistics/", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    header: {
      event_id: "a1b2c3d4-0000-0000-0000-000000000001",
      event_asof_dtutc: "2026-03-02T20:00:00Z"
    },
    sex: "male",
    age: 52.0
  })
});
if (!response.ok) throw new Error(`API error: ${response.status}`);
const data = await response.json();
console.log(`Scoring version: ${data.header.scoring_version}`);
console.log(`Retrieved stats for ${data.predictor_statistics.length} predictors.`);

import requests

url = "https://api.voloridgehealth.com/reference-data/"
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
response.raise_for_status()

data = response.json()
print(f"Retrieved {len(data)} reference entries.")

const response = await fetch("https://api.voloridgehealth.com/reference-data/", {
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
});

if (!response.ok) {
  throw new Error(`API error: ${response.status}`);
}

const data = await response.json();
console.log(`Retrieved ${data.length} reference entries.`);

curl -X GET "https://api.voloridgehealth.com/top-disease-predictors/" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.voloridgehealth.com/top-disease-predictors/",
    headers={"x-api-key": "YOUR_API_KEY"}
)
response.raise_for_status()
data = response.json()
for disease in data["top_disease_predictors"]:
    print(f"{disease['disease']}: {len(disease['predictors'])} predictors")

const response = await fetch("https://api.voloridgehealth.com/top-disease-predictors/", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
if (!response.ok) throw new Error(`API error: ${response.status}`);
const data = await response.json();
data.top_disease_predictors.forEach(({ disease, predictors }) => {
  console.log(`${disease}: ${predictors.length} predictors`);
});