Overview
Humanform is an anthropometrics prediction API. Given a measurement, population attributes, and a percentile (or an observed value), it returns modeled body dimensions you can use in product design, sizing, ergonomics, and research.
Base URL: https://api.humanform.app
Manage API keys, credits, and the playground in the dashboard.
Start here
- Quickstart — get a key and make your first request
- Authentication — Bearer API keys (
hf_live_…/hf_test_…) - Credits & billing — free tier and paid credits
- Errors — status codes and error shapes
- Catalog — measurements, countries, clothing, posture
Endpoints
| Endpoint | Path | What it does |
|---|---|---|
| Predict | POST /v1/predict | Predict a measurement at a percentile |
| Predict range | POST /v1/predict/range | Predict multiple percentiles in one call |
| Predict compare | POST /v1/predict/compare | Compare the same prediction across countries |
| Percentile lookup | POST /v1/percentile-lookup | Map an observed value to a percentile |
| Connected dimension | POST /v1/connected-dimension | Conditional linked-measurement bounds |
Limits
Authenticated routes are limited to 120 requests per 60 seconds per API key. Exceeding that returns 429 with a Retry-After header. See Errors.