Skip to content
Fitness Tools

Adaptive TDEE

POST
/v1/tools/adaptive-tdee

Measure actual TDEE from a logged history of daily weight and calorie intake (energy balance: mean intake minus stored energy, Wishnofsky 7700 kcal/kg). Use instead of formula TDEE once ~2+ weeks of real data exist.

Request Body required

Section titled “Request Body required ”
object
entries
required
Array<object>
>= 10 items <= 400 items
object
date
required
string
/^\d{4}-\d{2}-\d{2}$/
weight
required
object
value
required
number
unit
string
default: kg
Allowed values: kg lb
kcal
required
number
<= 20000
window_days
integer
default: 7 >= 3 <= 14
methods
Any of:
Array<string>
Example
{
  "entries": [
    {
      "date": "2026-01-01",
      "weight": {
        "value": 80,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-02",
      "weight": {
        "value": 79.95,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-03",
      "weight": {
        "value": 79.9,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-04",
      "weight": {
        "value": 79.85,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-05",
      "weight": {
        "value": 79.8,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-06",
      "weight": {
        "value": 79.75,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-07",
      "weight": {
        "value": 79.7,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-08",
      "weight": {
        "value": 79.65,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-09",
      "weight": {
        "value": 79.6,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-10",
      "weight": {
        "value": 79.55,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-11",
      "weight": {
        "value": 79.5,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-12",
      "weight": {
        "value": 79.45,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-13",
      "weight": {
        "value": 79.4,
        "unit": "kg"
      },
      "kcal": 2500
    },
    {
      "date": "2026-01-14",
      "weight": {
        "value": 79.35,
        "unit": "kg"
      },
      "kcal": 2500
    }
  ]
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Adaptive TDEE 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