Daily activity

Get activity for given date

Changed on

Get users activity for given date. Date cannot be older than 365 days from today.

get/v3/users/activities/{date}

Request

Path parameters

datestring date required

Date in format YYYY-MM-DD.

Query parameters

stepsboolean

include steps samples for activity summary.

activity_zonesboolean

include activity zones samples for activity summary.

inactivity_stampsboolean

include inactivity stamps for activity summary.

Response

Extended activity summaries with all samples.

start_timestring

Start time of the activity in UTC

end_timestring

End time of the activity in UTC

active_durationstring

The duration of the activity in ISO8601 format

inactive_durationstring

The duration of the inactivity in ISO8601 format

daily_activitynumber float

Daily activity score / percentage

caloriesinteger

Total calories burned during the day

active_caloriesinteger

Active calories burned during the day, excluding BMR

stepsinteger

Total number of steps taken during the day

inactivity_alert_countinteger

Number of inactivity alerts received during the day

distance_from_stepsnumber float

Distance covered based on steps taken, in meters

Example response

{
  "start_time": "2025-08-13T08:15:30",
  "end_time": "2025-08-13T23:59:59",
  "active_duration": "PT3H11M",
  "inactive_duration": "PT18H23M30S",
  "daily_activity": 89.1,
  "calories": 2500,
  "active_calories": 1500,
  "steps": 8823,
  "inactivity_alert_count": 1,
  "distance_from_steps": 4590.53,
  "samples": {
    "date": "2022-02-10",
    "steps": {
      "samples": [
        {
          "timestamp": "2025-08-14T00:02"
        }
      ]
    },
    "activity_zones": {
      "samples": [
        {
          "timestamp": "2025-08-14T00:08:30"
        }
      ]
    },
    "inactivity_stamps": [
      {
        "stamp": "2022-02-10T16:04"
      }
    ]
  }
}

Changes