Body Measurements
You can use this feature together with Nutritional Plans and Daily Nutritional Goal to personalize recommendations for each user.
Plan & Token Requirements
Feature available in the following LogMeal Plans:
Accessible by the following User Types:
⚫ APICompany | 🔴 APIUser | 🔵 APIUserManager
What It Does
Body Measurements allow you to store and monitor physical parameters such as weight, height, body fat percentage, waist circumference, and BMI for each user. These measurements help personalize caloric needs, compute health indicators, and track progress over time in dashboards or reports.


When to Use It / Outcomes
- You need to track weight or BMI changes over time to visualize progress.
- You want to compute metrics like BMI or body fat trends based on periodic measurements.
- Output: JSON confirming creation, update, or deletion of measurements, or historical data points for a user.
Feature-Specific Details
- Supported measurements: weight, height, BMI, body fat percentage, waist circumference, hip circumference, muscle mass, etc. Freely create your own personalized measurements.
- Automatic calculations: BMI and related indexes are automatically computed from weight and height if available.
- Units: metric system by default (kg, cm, %). You can create your own personalized measurements with your custom units.
- Timestamps: each record includes the measurement date, allowing progress tracking.
- Visibility: ⚫ APICompany and 🔵 APIUserManager can manage the list of available measures.
Related Endpoints
Use the following endpoints to create, list, and manage body measurement types:
- GET /measure → ⚫ 🔴 🔵 List all recorded measurement types available in the system. These measures will be available for all your users
- POST /measure → ⚫ 🔵 Add a new measurement type freely specifying the name and unit that you want.
- PATCH /measure → ⚫ 🔵 Edit existing measure type.
- DELETE /measure → ⚫ 🔵 Delete a specific measure type.
Use the following endpoints to create, list, and manage body measurement records:
- GET /user_measure → 🔴 🔵 List all recorded measurements for a user.
- POST /user_measure → 🔴 🔵 Add a new measurement record (weight, height, etc.).
- DELETE /user_measure → 🔴 🔵 Delete a specific measurement entry.
Use the following endpoints to create, list, and manage body measurement records that are associated and linked to specific Nutritional Plans:
- GET /user_measure_goal → 🔴 🔵 List all goal-related recorded measurements for a user.
- POST /user_measure_goal → 🔴 🔵 Add a new goal-related measurement record (weight, height, etc.).
- DELETE /user_measure_goal → 🔴 🔵 Delete a specific goal-related measurement entry.
Typical Workflow
- Define the measurements to track: start by creating any custom measurement types your organization or app needs, such as weight, waist circumference, or body fat percentage, using POST /measure.
- List available measurements: retrieve all created measurement types with GET /measure. These can be shown in your app for selection by users or managers.
- Record user measurements: add a new measurement record for a user with POST /user_measure. For example, log today’s weight or waist size.
- Review and monitor progress: use GET /user_measure to fetch and display a user’s historical data or progress charts.
- Set and manage goal-related measures: if users are following a Nutritional Plan, record their goal-related measurements (like target weight) with POST /user_measure_goal.
- Clean up or update data as needed: edit measurement names or units with PATCH /measure or remove old entries with DELETE /user_measure.
- Display insights in dashboards: combine the collected data with Nutritional Plans or Daily Nutritional Goals to show real progress trends, averages, and health summaries over time.
Updated about 11 hours ago