BodyDouble Endpoint

The BodyDouble endpoint wraps the BodyDbl statistical model to infer a complete set of BodyDbl field values from whichever baseline inputs you have available. Supply height, weight, age, or any other known measurements—leaving fields blank simply falls back to the underlying prediction model—to receive a harmonised list you can plug directly into pattern workflows.

All responses normalise values into your chosen unit system (metric or imperial) and flag whether each field was provided (source: "input") or predicted by the model.

Use neckSideToWaistBack for the neck-side-to-back-waist measurement. REST v1 also returns its former spelling, nackSideToWaistBack, as a deprecated alias for existing integrations. Both input spellings are accepted; the correctly spelled field takes precedence if both are supplied.

Endpoint

POST /api/v1/bodydbl

• Authentication: Required. Send Authorization: Bearer <API_KEY> using an API key issued from your SeamScape dashboard.
• Body (JSON, required):

  {
    "gender": "female" | "male",
    "unit": "metric" | "imperial",
    "measurementKey"?: number
  }

• Supply any known measurement directly at the top level (for example "height": 170, "chestGirth": 92.5, "waistArcFront": 38.1). Each value should match the selected unit system.

Available BodyDbl fields

The BodyDbl models expose the same measurement dictionary for both female and male templates. The 69 fields listed below are sourced directly from the canonical model metadata and represent every key you can send or expect in the response payload.

Response

The response returns fields: a dictionary keyed by measurement name with the inferred value, unit, and whether the number came from your input or the prediction engine. Values may be null when the model cannot infer a value from the supplied inputs.

{
  "gender": "female",
  "unit": "metric",
  "fields": {
    "height": { "value": 170, "unit": "cm", "source": "input" },
    "weight": { "value": 65, "unit": "kg", "source": "input" },
    "chestGirth": { "value": 92.13, "unit": "cm", "source": "predicted" },
    "waistGirth": { "value": 75.98, "unit": "cm", "source": "predicted" }
  }
}