Skip to content
Fitness Tools

Body Fat Percentage

POST
/v1/tools/body-fat

Estimate body-fat % via US Navy circumference, Jackson-Pollock 3-site skinfold, and Deurenberg (BMI-based) methods.

Request Body required

Section titled “Request Body required ”
object
sex
required
string
Allowed values: male female
age
number
nullable <= 120
height
object
value
required
number
unit
string
default: cm
Allowed values: cm in mm
weight
object
value
required
number
unit
string
default: kg
Allowed values: kg lb
neck
object
value
required
number
unit
string
default: cm
Allowed values: cm in mm
waist
object
value
required
number
unit
string
default: cm
Allowed values: cm in mm
hip
object
value
required
number
unit
string
default: cm
Allowed values: cm in mm
skinfold_sum
number
nullable
methods
Any of:
Array<string>
Example
{
  "sex": "male",
  "neck": {
    "value": 40,
    "unit": "cm"
  },
  "waist": {
    "value": 90,
    "unit": "cm"
  },
  "height": {
    "value": 180,
    "unit": "cm"
  }
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Body Fat Percentage result

object
results
required
Array<object>
object
method
required
string
value
required
number
unit
required
string
detail
object
key
additional properties
consensus
required
object
mean
required
number
median
required
number
min
required
number
max
required
number
n
required
integer
skipped
required
Array<object>
object
method
required
string
reason
required
string

400

Section titled “400 ”

Inputs valid but semantically impossible, or a required method’s inputs are missing.

object
error
required
object
type
required
string
message
required
string
details

422

Section titled “422 ”

Input failed validation (Zod).

object
error
required
object
type
required
string
message
required
string
details