Skip to content
Fitness Tools

Macronutrient Split

POST
/v1/tools/macros

Compute protein/fat/carb grams for a calorie target using the g-per-kg-bodyweight method, with goal-based protein defaults.

Request Body required

Section titled “Request Body required ”
object
calories
required
number
weight
required
object
value
required
number
unit
string
default: kg
Allowed values: kg lb
goal
string
default: maintain
Allowed values: cut maintain bulk
protein_g_per_kg
number
nullable <= 4
fat_g_per_kg
number
nullable <= 3
methods
Any of:
Array<string>
Example
{
  "calories": 2500,
  "weight": {
    "value": 80,
    "unit": "kg"
  },
  "goal": "maintain"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Macronutrient Split 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

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