Articles in this section

Fitbit Profiles Data Export Format

  • Updated
Follow

The Fitbit Profiles export contains preferences and other profile information associated with a participant's Fitbit account. Each entry contains the profile data for a single participant.

Many of the settings in the Fitbit profile relate to the participant's selected preferences for units of measure and locale. These preferences do not impact the data in the export. For example, Height is always exported in centimeters, even if the participant prefers feet/inches. 

The data in the Fitbit export is obtained through the Fitbit API. The available data will vary based on the device capabilities and the participant's privacy settings. See the Fitbit "Get Profile" 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).
ModifiedDate The date the profile was last updated, in ISO 8601 format.
AboutMe Contents of the Fitbit user's "About Me" profile tab.
ClockTimeDisplayFormat Preferred clock time format, either 12hour or 24hour.
DistanceUnit Preferred distance unit.
EncodedId Participant's unique Fitbit identifier.
FoodsLocale Locale code for the participant's selected food database.
GlucoseUnit Preferred glucose unit.
Height Participant's height, in centimeters.
HeightUnit Preferred height units.
Locale Preferred locale.
MemberSince Date the participant joined Fitbit. 
OffsetFromUTCMillis Offset for the participant's timezone. 
StartDayOfWeek Preferred day for the week to start on, either Sunday or Monday. 
StrideLengthRunning Running stride length, in centimeters. 
StrideLengthWalking Walking stride length, in centimeters. 
Timezone Participant's timezone, in the format "America/New_York".
WaterUnit Preferred unit when displaying water-consumed, as reported in the nutrition logs. Although we collect nutrition data, it is not currently included in exports.
Weight Participant's reported weight, in kilograms.
WeightUnit Preferred unit when displaying weight.

Sample CSV Export

ParticipantIdentifier,ModifiedDate,AboutMe,ClockTimeDisplayFormat,DistanceUnit,EncodedId,FoodsLocale,GlucoseUnit,Height,HeightUnit,Locale,MemberSince,OffsetFromUTCMillis,StartDayOfWeek,StrideLengthRunning,StrideLengthWalking,Timezone,WaterUnit,Weight,WeightUnit
aaaa-bbbb-cccc-dddd,2020-03-02T21:52:20Z,,12hour,en_US,AAABBB,en_US,en_US,157.4,en_US,en_US,2019-04-22,-18000000,SUNDAY,91.9,65,America/New_York,,56.9,en_US
1111-2222-3333-4444,2020-03-09T01:26:52Z,,12hour,en_US,ABCDEF,en_US,en_US,157.4,en_US,en_US,2019-04-22,-14400000,SUNDAY,91.9,65,America/New_York,,56.9,en_US

Sample JSON Export

{
    "ParticipantIdentifier": "aaaa-bbbb-cccc-dddd",
    "ModifiedDate": "2020-05-26T21:18:56Z",
    "AboutMe": "All about me.",
    "ClockTimeDisplayFormat": "12hour",
    "DistanceUnit": "en_US",
    "EncodedId": "AABBCC",
    "FoodsLocale": "en_US",
    "GlucoseUnit": "en_US",
    "Height": "157.4",
    "HeightUnit": "en_US",
    "Locale": "en_US",
    "MemberSince": "2019-04-22",
    "OffsetFromUTCMillis": "-14400000",
    "StartDayOfWeek": "SUNDAY",
    "StrideLengthRunning": "91.9",
    "StrideLengthWalking": "65",
    "Timezone": "America\/New_York",
    "WaterUnit": "en_US",
    "Weight": "56.9",
    "WeightUnit": "en_US"
}

Related articles