Daily Nutritional Goals

You can initialize goals from Recommended Daily Intake and combine them with Nutritional Plans. Alternatively, if you need more precision in your personalization, you can manually edit the daily goals for each user manually.

Plan & Token Requirements

Feature available in the following LogMeal Plans:

Accessible by the following User Types:

What It Does

Daily Nutritional Goal stores target values and ranges for energy (kcal), macronutrients and, depending on your plan, micronutrients (e.g., fiber, sugar, sodium, potassium, vitamins and minerals). These goals are used across the platform to compute Remaining Daily Intake and to evaluate a user's progress. If no explicit goals are defined, the system can fallback to Recommended Daily Intake for baseline targets.

✕

✕

When to Use It / Outcomes

• You want to pin personalized targets for a user (kcal, macros, and micronutrients).
• You need explicit goals instead of relying only on user profile generic recommendations.
• You maintain coaching or plan assignments and want goals to adapt accordingly.
• Output: JSON with the user's current goals (GET), confirmation of updates (POST) or deletion (DELETE).

Feature-Specific Details

• Goal structure: targets typically include either a single target value or a min/max (or range + warning_range) per nutrient.
• Units: each nutritional indicator has its own fixed unit. Kcal for energy; grams for macros and most nutrients; milligrams or micrograms for some micronutrients.
• Plan integration: assigning a Nutritional Plan automatically defines/updates daily goals to accomplish that plan.
• Fallbacks: when manually defined goals are missing, Recommended Daily Intake can be used to bootstrap good defaults.
• Localization: nutrient display names can be localized in your UI; the API returns canonical nutrient keys.

Related Endpoints

• GET /daily_nutritional_goal → ⚫ 🔴 🔵 Retrieve the user's current daily nutritional goals.

• POST /daily_nutritional_goal → ⚫ 🔴 🔵 Create or update daily nutritional goals for the user.

• DELETE /daily_nutritional_goal → ⚫ 🔴 🔵 Delete the user's daily nutritional goals.

• POST /daily_nutritional_goal/autocompute → ⚫ 🔵 Automatically personalize daily nutritional goals using the user profile info (sex, age, weight, height and activity level).

• Optional helpers:

  • GET /nutrition/getRecommendedDailyIntake → 🔴 Baseline recommendations to initialize goals.

Typical Workflow

For manually defined goals

1. Fetch recommendations via GET /nutrition/getRecommendedDailyIntake, or compute targets from an active Nutritional Plan.
2. Create/update goals with POST /daily_nutritional_goal.
3. Retrieve & display goals using GET /daily_nutritional_goal.
4. Use goals to compute Remaining Daily Intake and to power progress UIs; delete with DELETE /daily_nutritional_goal if you want to revert to recommendations.

For automatically defined goals

1. Ensure user profile data includes sex, age, weight, height, and activity level, required for automatic calculations.
2. Auto-generate goals via POST /daily_nutritional_goal/autocompute, which personalizes kcal, macros, and micronutrients based on the user profile.
3. Nutritional Plans integration: assigning a plan automatically defines or updates the Daily Nutritional Goals required to accomplish it.
4. Retrieve and display the computed targets using GET /daily_nutritional_goal.
5. Re-compute when profile changes (e.g., weight or activity updates).
6. Use these goals in progress dashboards for automatic tracking.