Predict compare

Updated Jul 17, 2026

Compare the same measurement prediction across multiple countries in one request.

POST/v1/predict/compare

Summary

Holds measurement, gender, age, percentile, and unit fixed while varying country. Useful for international sizing and market comparison.

Cost: 1 credit (or free-tier call) per returned country. Maximum 10 unique countries.

Request

Field	Type	Required	Notes
`measurement`	string	yes	Measurement name
`gender`	string	yes	`Male` or `Female`
`age`	number	yes	0–120
`percentile`	number	yes	1–99
`countries`	string[]	yes	Country codes; max 10 unique
`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/predict/compare \
  -H "Authorization: Bearer hf_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "measurement": "Stature",
    "gender": "Male",
    "age": 30,
    "percentile": 50,
    "unit": "mm",
    "countries": ["US", "UK", "JP"]
  }'

{
  "measurement": "Stature",
  "gender": "Male",
  "age": 30,
  "percentile": 50,
  "unit": "mm",
  "countries": ["US", "UK", "JP"]
}

Response

{
  "measurement": "Stature",
  "gender": "Male",
  "percentile": 50,
  "clothing": "nude",
  "posture": "standing_erect",
  "unit": "mm",
  "source": "modeled",
  "values": [
    { "country": "US", "value": 1765.3 },
    { "country": "UK", "value": 1754.2 },
    { "country": "JP", "value": 1712.8 }
  ]
}

Notes

Country codes must be supported by the API catalog (GET /).
Insufficient free-tier or credits for the full country list yields insufficient_predictions.