---
title: "Calculate Pheno Age"
method: POST
path: "/api/data/pheno-age"
tags: ["Data"]
---

# Calculate Pheno Age

`POST /api/data/pheno-age`

Calculates a Pheno Age result from chronological age and the nine required blood biomarkers. The result includes Biological Age Difference, which can be passed to the hypothetical rank endpoint as the submitted biological age.

## Request body

- PhenoAgeCalculationRequest — Inputs for calculating the Longevity World Cup Pheno Age result. Units match the public athlete biomarker JSON.
  - `chronologicalAge` number, double, required — Chronological age in years at the biomarker measurement date.
  - `albGL` number, double, required — Albumin in g/L.
  - `creatUmolL` number, double, required — Creatinine in umol/L.
  - `gluMmolL` number, double, required — Glucose in mmol/L.
  - `crpMgL` number, double, required — C-reactive protein in mg/L. Must be greater than 0 because the clock applies a logarithm.
  - `wbc1000cellsuL` number, double, required — White blood cell count in 1000 cells/uL.
  - `lymPc` number, double, required — Lymphocyte percentage.
  - `mcvFL` number, double, required — Mean corpuscular volume in fL.
  - `rdwPc` number, double, required — Red cell distribution width percentage.
  - `alpUL` number, double, required — Alkaline phosphatase in U/L.

## Response `200`

Calculated Pheno Age result, Biological Age Difference, pace of aging, and domain contribution values.

- PhenoAgeCalculationResult — Calculated Pheno Age result and derived values useful for rank previews.
  - `biologicalAge` number, double — Calculated Pheno Age in years.
  - `biologicalAgeDifference` number, double — Signed biological age minus chronological age. Lower and more negative values rank higher within the Amateur field.
  - `paceOfAging` number, double — Calculated biological age divided by chronological age.
  - `domainContributions` PhenoAgeDomainContributions — Pheno Age model contribution values grouped by biological domain.
    - `liver` number, double — Albumin and alkaline phosphatase contribution value.
    - `kidney` number, double — Creatinine contribution value.
    - `metabolic` number, double — Glucose contribution value.
    - `inflammation` number, double — C-reactive protein contribution value.
    - `immune` number, double — White blood cell, lymphocyte, MCV, and RDW contribution value.

## Other responses

- `400` — Invalid request body or out-of-range Pheno Age input.

---

[API](https://skmtc.dev/longevityworldcup/apis/longevity-world-cup-public-api.md) · [All operations](https://skmtc.dev/longevityworldcup/apis/longevity-world-cup-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/longevityworldcup/longevity-world-cup-public-api/revisions/06294996061a/schema)