Predict

Updated Jul 17, 2026

Predict a single anthropometric measurement for a population slice at a target percentile.

POST/v1/predict

Summary

Returns a modeled (or derived) measurement value for the requested gender, age, country, percentile, and optional clothing/posture adjustments.

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

Request

Field	Type	Required	Notes
`measurement`	string	yes	e.g. `Stature`, `SittingHeight`
`gender`	string	yes	`Male` or `Female`
`age`	number	yes	0–120
`percentile`	number	yes	1–99
`country`	string	no	ISO-style code; default `US`
`unit`	string	no	`mm` (default), `cm`, or `in`
`clothing`	string	no	default `nude`
`posture`	string	no	default `standing_erect`

Clothing ids: nude, light, shoes, winter, light_shoes
Posture ids: standing_erect, standing_relaxed, sitting

Supported measurements, countries, clothing, and posture values are listed in the API catalog (GET /).

Example

curl -sS https://api.humanform.app/v1/predict \
  -H "Authorization: Bearer hf_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "measurement": "Stature",
    "gender": "Male",
    "age": 30,
    "percentile": 50,
    "country": "UK",
    "unit": "mm",
    "clothing": "light_shoes",
    "posture": "standing_relaxed"
  }'

{
  "measurement": "Stature",
  "gender": "Male",
  "age": 30,
  "percentile": 50,
  "country": "UK",
  "unit": "mm",
  "clothing": "light_shoes",
  "posture": "standing_relaxed"
}

Response

{
  "measurement": "Stature",
  "gender": "Male",
  "country": "UK",
  "clothing": "light_shoes",
  "posture": "standing_relaxed",
  "value": 1754.2,
  "unit": "mm",
  "source": "modeled"
}

Field	Notes
`value`	Predicted measurement; mm/cm rounded to 1 decimal, inches to 2
`source`	`modeled` or `derived`
`remaining_free_calls`	Present on some free-tier successes

Notes

See Errors for validation and model-not-found responses.
Enum lists: Catalog or live GET /.
For multiple percentiles in one call, use Predict range.
For the same percentile across countries, use Predict compare.