Health tracking
The Health area keeps daily records next to your activities: weight, steps, sleep, resting heart rate, water, bowel movements and fasting. Each metric has its own page, a history you can filter, and an optional target. The Health dashboard shows today at a glance.
Health records belong to your account. Unlike activities, they have no visibility setting or public link.
Your day is your timezone
"Today" means your calendar day, in the timezone set in your profile. A record added without a date is stored on your today. If your timezone is wrong, a late-evening record can land on the wrong day, so set it first under Settings → My profile.
The metrics
| Metric | What a record holds | Records per day |
|---|---|---|
| Weight | Weight in kilograms or pounds, and optionally body fat, body water, bone mass, muscle mass, visceral fat, physique rating and metabolic age | One |
| Steps | Step count | One |
| Sleep | Start and end, total, deep, light, REM and awake time, awakenings, stress, heart rate, SpO2, respiration, HRV status and the sleep scores | One |
| Water | A total in millilitres | One per day |
| Bowel movements | Date and time, Bristol stool type 1–7, colour and notes | Any number |
| Fasting | Start, end, protocol, target duration, status and notes | One running fast at a time |
For weight, steps and sleep, adding a second record for a date that already has one is refused with a conflict. Edit the existing record instead.
Records come from you or, for weight, steps and sleep, from a Garmin Connect sync. The record keeps its source.
The dashboard
The dashboard reads each metric for your today and shows only what exists:
| Card | Shows |
|---|---|
| Sleep | Total sleep |
| Resting HR | Resting heart rate and the HRV status |
| Skin temp. dev. | Skin temperature deviation |
| Weight | Your latest weight, not only today's |
| BMI | The BMI of your latest weight, with its class |
| Steps | Today's steps |
| Fasting | The running fast, if any |
| Water intake | Today's total |
| Bowel movements | Today's count |
Cards with a target show it next to the value.
A card with no data reads No data rather than zero.
The dashboard response (GET /api/v1/health/stats/daily) also carries your targets, but only for a caller that holds the health-targets:read scope. Without it targets is null.
Weight and BMI
Weight is shown in kilograms or pounds, chosen under Settings → My profile → Edit profile → Weight units. Left on Follow units it uses your account's units, so a metric account can weigh itself in pounds while distance, pace and elevation stay metric.
BMI is worked out from the weight and the height in your profile when you do not supply one. Without a height there is no BMI. When you change your height, the BMI of the weight records you entered yourself is recalculated; records from a provider keep the BMI the provider reported.
Water
Water is one total per day, like weight, steps and sleep. Logging water for a day that already has an entry is refused: edit that day's entry to change the total.
Bowel movements
Each movement is its own record. The Bristol type runs from 1 (separate hard lumps) through 4 (smooth, soft sausage, the ideal) to 7 (liquid). The colour is one of brown, dark brown, light brown, yellow, green, black, red or white. Treat this as a personal log, not medical advice.
Fasting
You can have one running fast. Starting another while one runs, or one whose times overlap another fast, is refused: finish or cancel the first.
Pick a protocol when you start: 16:8, 18:6, 20:4, OMAD, 24h, 36h, 48h, 72h or custom. The web form sets the target duration from the protocol (OMAD is 23 hours); with custom you enter the hours. The API accepts any target duration.
stateDiagram-v2
[*] --> in_progress: Start a fast
in_progress --> completed: End the fast (default)
in_progress --> broken: End it as broken
in_progress --> cancelled: Cancel it
completed --> [*]
broken --> [*]
cancelled --> [*]
The fasting page also shows statistics over your history:
| Statistic | Meaning |
|---|---|
| Total fasts | Completed fasts |
| Current streak and longest streak | Consecutive days with a completed fast. The current streak counts only when the latest completed fast was today or yesterday |
| Average duration | Mean length of your fasts |
| Total fasting time | All time spent fasting |
| Completion rate | Percentage of started fasts that were completed |
Targets
Set a target for any metric under the metric's page: weight (kg or lb), daily steps, sleep duration, fasting duration, daily water (ml) and daily bowel movements. Targets appear as goal lines in the charts. They are stored together, and changing one keeps the others.
History
Every metric page lists records newest first and filters them to the last 7, 30 or 90 days, the last year or all time. The page size is the server's Records per page setting.
Editing at the same time on two devices
Each record carries a version. If you save a record that you opened before it changed elsewhere (another device, or a Garmin sync that updated the day), the save is refused with a message that the record changed. Reload and try again. API clients see this as 412; see Errors, concurrency and rate limits.