Sign in

v2

latestOpenAPI 3.0.42026-08-0161443.4 KB
Data

Preview a hypothetical Ultimate League rank

Calculates where a hypothetical biological age result would rank in the current Ultimate League field. Use pheno for an Amateur Pheno Age preview and bortz for a Pro Bortz Age preview.

post/api/data/hypothetical-rank

Request body

calculator'pheno' | 'bortz' required

Biological aging clock to preview: pheno for Amateur or bortz for Pro.

chronologicalAgenumber double

Chronological age in years at the measurement date.

biologicalAgenumber double

Biological age result in years from the selected clock.

birthYearinteger

Birth year used for tie-breaking against the current field.

birthMonthinteger

Birth month used for tie-breaking against the current field.

birthDayinteger

Birth day used for tie-breaking against the current field.

Example request

{
  "calculator": "pheno",
  "chronologicalAge": 45.5,
  "biologicalAge": 38.2,
  "birthYear": 1980,
  "birthMonth": 6,
  "birthDay": 15
}

Response

Hypothetical rank, field sizes, signed age difference, and nearby rows.

rankinteger

One-based rank the hypothetical result would receive in the selected field.

fieldSizeinteger

Field size including the hypothetical result.

currentFieldSizeinteger

Current field size excluding the hypothetical result.

leagueNamestring nullable

League used for the preview. Currently Ultimate League.

categorystring nullable

Track used for the preview, either Pro or Amateur.

ageDifferencenumber double

Signed biological age difference, calculated as biological age minus chronological age. Lower and more negative values rank higher within the same track.