Connected dimension

Updated Jul 17, 2026

Estimate a linked measurement distribution conditioned on an anchor measurement percentile, including accommodation bounds.

POST/v1/connected-dimension

Summary

Given an anchor measurement at a known percentile (for example stature at P50), returns the conditional mean and lower/upper bounds for a linked measurement (for example sitting height) at an accommodation percentage, plus optional density samples for charting.

Cost: 1 credit or 1 free-tier call on success.

Request

Field	Type	Required	Notes
`anchorMeasurement`	string	yes	Conditioning measurement
`anchorPercentile`	number	yes	1–99
`linkedMeasurement`	string	yes	Measurement to estimate
`accommodationPercent`	number	yes	1–99
`gender`	string	yes	`Male` or `Female`
`age`	number	yes	0–120
`country`	string	no	Default `US`
`unit`	string	no	`mm`, `cm`, or `in`
`clothing`	string	no	Default `nude`
`posture`	string	no	Default `standing_erect`

Example

curl -sS https://api.humanform.app/v1/connected-dimension \
  -H "Authorization: Bearer hf_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "anchorMeasurement": "Stature",
    "anchorPercentile": 50,
    "linkedMeasurement": "SittingHeight",
    "accommodationPercent": 95,
    "gender": "Male",
    "age": 30,
    "country": "US",
    "unit": "mm"
  }'

{
  "anchorMeasurement": "Stature",
  "anchorPercentile": 50,
  "linkedMeasurement": "SittingHeight",
  "accommodationPercent": 95,
  "gender": "Male",
  "age": 30,
  "country": "US",
  "unit": "mm"
}

Response

{
  "anchorMeasurement": "Stature",
  "anchorPercentile": 50,
  "linkedMeasurement": "SittingHeight",
  "accommodationPercent": 95,
  "conditionalMean": 912.4,
  "lowerBound": 868.1,
  "upperBound": 956.7,
  "unit": "mm",
  "distributionPoints": [
    { "value": 850.123, "density": 0.0012 },
    { "value": 912.4, "density": 0.0187 }
  ]
}

distributionPoints is a sampled curve (on the order of ~60 points) suitable for plotting. Response field shapes match the public API catalog.

Notes

Optional clothing / posture follow the same defaults as other prediction endpoints. See Catalog.
Statistical failures may return 422 with invalid_marginal_distribution.