Articles in this section

Fitbit Activity Log Data Export Format

  • Updated
Follow

The Fitbit Activity export contains information about participant exercise activities. Each entry contains information for a single activity session. 

The activity log can include activities from Fitbit's automatic activity tracking as well as activities entered manually by the user.

The data in the Fitbit export is obtained through the Fitbit API. The available data will vary based on the device capabilities and the user's privacy settings. See the Fitbit "Get Activity Log List" documentation for more information about using and interpreting Fitbit data.

Table of Contents

Data Fields

Field Description
ActiveDuration The duration of the activity, in milliseconds.
ActivityName The name of the activity (e.g., Walk or Sport).
ActivityTypeId The internal Fitbit identifier for the activity (e.g., walking is 90013).
AverageHeartRate The user's average heart rate during the activity.
Calories Calories burned during the activity.
Duration The duration of the activity, in milliseconds.
EndDate The end date for the activity, in ISO 8601 format. Includes timezone offset information.
FairlyMinutes The number of minutes the user was "fairly active" during the activity. 
HeartRateZoneCardioMax See Zones, below.
HeartRateZoneCardioMin See Zones, below.
HeartRateZoneCardioMinutes See Zones, below.
HeartRateZoneFatBurnMax See Zones, below.
HeartRateZoneFatBurnMin See Zones, below.
HeartRateZoneFatBurnMinutes See Zones, below.
HeartRateZoneOutOfRangeMax See Zones, below.
HeartRateZoneOutOfRangeMin See Zones, below.
HeartRateZoneOutOfRangeMinutes See Zones, below.
HeartRateZonePeakMax See Zones, below.
HeartRateZonePeakMin See Zones, below.
HeartRateZonePeakMinutes See Zones, below.
LastModified A timestamp indicating when the activity was last modified, in ISO 8601 format.
LightlyMinutes The number of minutes the user was "lightly active" during the activity. 
LogID The unique identifier in Fitbit’s system for the activity log
record.
LogType The type of activity log: auto_detected, fitstar, manual, mobile_run, or tracker.
ManualValueSpecifiedCalories Manually-entered value for calories. 
ManualValueSpecifiedDistance Manually-entered value for distance. 
ManualValueSpecifiedSteps Manually-entered value for steps. 
OriginalDuration The activity duration, excluding any manual user modifications.
OriginalStartTime The activity start time, excluding any manual user modifications. 
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
ParticipantIdentifier The MyDataHelps Designer identifier of the participant associated with the Fitbit user. Can be used to cross reference with Participants.
SedentaryMinutes The number of minutes the user was "sedentary" during the activity.
StartDate The start date for the activity, in ISO 8601 format. Includes timezone offset information.
Steps The number of steps during the activity. 
VeryMinutes The number of minutes the user was "very active" during the activity. 

Zones

For an activity, Fitbit tracks various heart rate "zones," like "Fat Burn" or "Cardio." For each zone, it reports:

  • The minimum and maximum heart rates that define the zone. For example: the "Fat Burn" zone might be between 93 and 130.
  • The number of minutes the user spent in that zone during the activity.

Sample CSV Export

ParticipantIdentifier,StartDate,EndDate,ActiveDuration,ActivityName,ActivityTypeId,AverageHeartRate,Calories,Duration,LastModified,LogType,ManualValueSpecifiedCalories,ManualValueSpecifiedDistance,ManualValueSpecifiedSteps,OriginalDuration,OriginalStartTime,Steps,HeartRateZoneOutOfRangeMax,HeartRateZoneOutOfRangeMin,HeartRateZoneOutOfRangeMinutes,HeartRateZoneFatBurnMax,HeartRateZoneFatBurnMin,HeartRateZoneFatBurnMinutes,HeartRateZoneCardioMax,HeartRateZoneCardioMin,HeartRateZoneCardioMinutes,HeartRateZonePeakMax,HeartRateZonePeakMin,HeartRateZonePeakMinutes,SedentaryMinutes,LightlyMinutes,FairlyMinutes,VeryMinutes,LogID
aaaa-bbbb-cccc-dddd,2020-04-03T18:05:08-04:00,2020-04-03T18:23:02-04:00,1074000,Walk,90013,107,81,1074000,2020-04-03T22:39:29.000Z,auto_detected,,,,1074000,2020-04-03T18:05:08.000-04:00,1575,93,30,0,130,93,18,158,130,0,220,158,0,0,5,7,6,51033094968
aaaa-bbbb-cccc-dddd,2019-05-06T17:05:46-04:00,2019-05-06T17:27:07-04:00,1281000,Run,90009,132,288,1281000,2019-05-06T21:32:57.000Z,auto_detected,,,,1281000,2019-05-06T17:05:46.000-04:00,2153,93,30,0,130,93,15,158,130,7,220,158,0,0,0,0,22,51095237973
1111-2222-3333-4444,2020-03-09T18:07:26-04:00,2020-03-09T18:24:31-04:00,1025000,Sport,15000,114,71,1025000,2020-03-09T22:29:20.000Z,auto_detected,,,,1025000,2020-03-09T18:07:26.000-04:00,843,93,30,0,130,93,14,158,130,3,220,158,0,0,6,8,3,51095237977

Sample JSON Export

{
    "ParticipantIdentifier": "aaaa-bbbb-cccc-dddd",
    "StartDate": "2019-10-09T14:38:58-04:00",
    "EndDate": "2019-10-09T15:03:43-04:00",
    "ActiveDuration": "1485000",
    "ActivityName": "Walk",
    "ActivityTypeId": "90013",
    "AverageHeartRate": "93",
    "Calories": "89",
    "Duration": "1485000",
    "LastModified": "2019-10-09T19:09:03.000Z",
    "LogType": "auto_detected",
    "ManualValueSpecifiedCalories": "0",
    "ManualValueSpecifiedDistance": "0",
    "ManualValueSpecifiedSteps": "0",
    "OriginalDuration": "1485000",
    "OriginalStartTime": "2019-10-09T14:38:58.000-04:00",
    "Steps": "1599",
    "HeartRateZone": {
        "OutOfRangeMax": "93",
        "OutOfRangeMin": "30",
        "OutOfRangeMinutes": "12",
        "FatBurnMax": "130",
        "FatBurnMin": "93",
        "FatBurnMinutes": "13",
        "CardioMax": "158",
        "CardioMin": "130",
        "CardioMinutes": "0",
        "PeakMax": "220",
        "PeakMin": "158",
        "PeakMinutes": "0"
    },
    "SedentaryMinutes": "0",
    "LightlyMinutes": "24",
    "FairlyMinutes": "0",
    "VeryMinutes": "0",
    "LogId": "51095237977"
}

Related articles