---
title: "Preview a starting nutrition plan without changing settings"
method: POST
path: "/v1/nutrition/recommendation"
tags: ["nutrition"]
---

# Preview a starting nutrition plan without changing settings

`POST /v1/nutrition/recommendation`

## Request

- Base URL: `http://localhost:4318`
- URL: `http://localhost:4318/v1/nutrition/recommendation`
- Auth: HTTP bearer

## Request body

- object
  - `weightUnit` 'kg' | 'lb'
  - `gender` string: Optional self-described gender; never substitutes for the equation coefficient.
  - `aspirations` string
  - `age` integer
  - `weightKg` number
  - `heightCm` number
  - `equationSex` 'male' | 'female': Coefficient from the original resting-energy equation; ask, never infer from name. May be omitted with established maintenance calories.
  - `activityFactor` number: Whole-day activity multiplier including exercise. NIDDK typical range 1.4 sedentary to 2.5 very active; this remains an estimate.
  - `knownMaintenanceKcal` number
  - `maintenanceEvidence` string: How maintenance was established. Never infer it from partially logged intake.
  - `goal` 'maintain' | 'lose_fat' | 'gain_muscle'
  - `training` 'none' | 'endurance' | 'resistance' | 'mixed'
  - `pregnantOrBreastfeeding` boolean
  - `requiresClinicalDiet` boolean: A condition or medication requiring individualized nutrition, e.g. kidney disease or glucose-lowering treatment.
  - `eatingDisorderHistory` boolean
  - `pace` 'gentle' | 'moderate'
  - `dietPreference` 'flexible' | 'mediterranean' | 'vegetarian' | 'vegan'
  - `macroPreference` 'balanced' | 'more_carbs' | 'more_fat'
  - `proteinGPerKg` number
  - `targetWeightKg` number

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid bearer token
- `409`: Revision or idempotency conflict
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nibb/apis/nibb-api.md) · [All operations](https://skmtc.dev/nibb/apis/nibb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nibb/apis/nibb-api/revisions/75bcd8b761ed?raw)