Health

Get comprehensive health summary (Pinned Stats)

Returns all pinned stats including movement, recovery, heart rate, sleep, water intake, stress level, calories, and distance for the day

get/api/health/move-summary

Request

  • Base URL
    https://api.hiyd.ai
  • Auth
    HTTP bearer

Query parameters

datestring date
Example:2026-01-24

Date for the summary (defaults to today)

time_zonestring
Example:America/Los_Angeles

IANA zone the day and its hours are counted in. Omitted or unrecognised values mean UTC. steps.total is the local day's total: phone (Health) steps when there are any, else the tracker's hourly rows in this zone (the UTC-day rollup only on a day the zone sits at UTC+0 all day). No tracker hours yet means 0 with an empty chart, never last evening's steps.

Response

Comprehensive health summary data

datestring date

Example response

{
  "movement_score": {
    "value": 75,
    "rating": "Excellent"
  },
  "recovery_score": {
    "value": 74,
    "rating": "Need Work"
  },
  "heart_rate": {
    "current": 72
  },
  "steps": {
    "total": 5120
  },
  "strength_time": {
    "period": "last_7_days",
    "total_minutes": 90,
    "formatted": "1h 30m"
  },
  "sleep": {
    "total_minutes": 372,
    "hours": 6,
    "minutes": 12,
    "formatted": "6h 12m"
  },
  "sleep_score": {
    "value": 82,
    "percentage": 82,
    "rating": "Excellent"
  },
  "water_intake": {
    "total_ml": 500,
    "glasses": 2,
    "formatted": "2 Glasses"
  },
  "stress": {
    "level": "LOW",
    "hrv_score": 65,
    "source": "HRV"
  },
  "calories": {
    "total": 2340,
    "active": 450
  },
  "active_minutes": {
    "total": 87,
    "formatted": "87 mins"
  },
  "distance": {
    "meters": 3800,
    "km": "3.80",
    "formatted": "3.8 km"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.