Weight history
get_weight_historyRetrieve body-composition and weight measurements for a sub-user or all users, with optional time-window filtering and cached results for trend analysis.
Instructions
Return body-composition / weight measurements, optionally filtered by sub-user (suid) and time window.
Data is fetched lazily when no valid cache exists and stored in a global cache shared by all tools for 5 minutes; subsequent queries use that cached snapshot until it expires. Use refresh_sync if you are within the 5-minute cache window and fresher data is required.
Returns a list ordered newest first. Each measurement contains weight_kg, weight_lb, bmi, bfr_pct (body fat percentage), rom_pct (muscle percentage), rosm_pct (skeletal muscle percentage), vwc_pct (body water percentage), pp_pct (protein percentage), sfr_pct (subcutaneous fat percentage), uvi (visceral fat index), bm_kg (bone mass), bmr_kcal (basal metabolic rate), bodyage (body age), measured_at (ISO 8601 timestamp), measured_time (Unix-seconds timestamp), data_id, suid, uid, and is_deleted. Set include_ext_data: true to also return ext_data for each record.
ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation.
Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only).
Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields.
Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight).
Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard.
Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index).
Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree.
Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null.
Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer.
By default includes tombstoned records (is_deleted: 1); set include_deleted: false to hide them.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_weight_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| suid | No | Sub-user id resolved by `list_users`. Omit to return records for all users. | |
| limit | No | Maximum number of records (newest first). Default: 100. | |
| since | No | Only include records measured at or after this unix-seconds timestamp. | |
| until | No | Only include records measured at or before this unix-seconds timestamp. | |
| include_deleted | No | Include records with `is_deleted: 1` (server-side tombstones). Default: true. | |
| include_ext_data | No | Include the `ext_data` reference/context object on each record. Leave it off when only the measurements are needed, such as for plotting trends. Default: false. |