Skip to main content

Fitbit Devices Data Export Format

  • Updated

The Devices export contains information about the Fitbit devices used by participants. Each entry contains data about a single device. There may be multiple devices per participant.

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 Devices" documentation for more information about using and interpreting Fitbit data.

Table of Contents

Data Fields

Field Description
ParticipantIdentifier The MyDataHelps Designer identifier of the participant associated with the Fitbit user. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
Date The date the device was last synced with the participant's FitBit app, in ISO 8601 format.
Device The device model (e.g., Charge 3 or Aria).
Battery The device's last recorded battery level (e.g., High, Medium, Low, or Empty).
Type The type of device (e.g., Tracker or Scale).
DeviceID Fitbit device identifier.
Mac Fitbit Mac identifier. 

Sample CSV Export

ParticipantIdentifier,Date,Device,Battery,Type,ParticipantID,DeviceID,Mac
5df1eae6-b56b-45ea-bc87-5f5f2bf8253f,2022-05-16T11:39:33,Charge 3,High,TRACKER,b9c63dfd-dfca-ec11-aaac-9992869f06a0,2018047336,
709e0df4-bad7-4b10-b72a-f5812af7d219,2023-05-11T11:11:28,Charge 3,Empty,TRACKER,3aa04d8f-8ebb-4163-962e-470d33784a2b,2151366099,9182DFF0F5D5

Sample JSON Export

{
    "ParticipantIdentifier": "5df1eae6-b56b-45ea-bc87-5f5f2bf8253f",
    "Date": "2022-05-16T11:39:33",
    "Device": "Charge 3",
    "Battery": "High",
    "Type": "TRACKER",
    "ParticipantID": "B9C63DFD-DFCA-EC11-AAAC-9992869F06A0",
    "DeviceID": "2018047336"
}
{
    "ParticipantIdentifier": "709e0df4-bad7-4b10-b72a-f5812af7d219",
    "Date": "2023-05-11T11:11:28",
    "Device": "Charge 3",
    "Battery": "Empty",
    "Type": "TRACKER",
    "ParticipantID": "3AA04D8F-8EBB-4163-962E-470D33784A2B",
    "DeviceID": "2151366099",
    "Mac": "9182DFF0F5D5"
}

Was this article helpful?