Fitbit Body Weight Log Export Format
- Updated
The Body Weight Log export contains user-provided weight and Body Mass Index (BMI) data from their Fitbit account. Data could be manually entered by the user or come from a connected scale.
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 Weight Log" documentation for more information about using and interpreting Fitbit data.
Data Fields
| Field | Description |
|---|---|
FitbitBodyWeightLogKey |
Unique key value for this log record. |
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. |
InsertedDate |
The creation date of the entry, in ISO 8601 format. Is always in UTC. |
LogID |
The unique identifier in Fitbit’s system for the activity log record, unique for each user but not globally. |
DateTime |
The date and time the measurement was recorded, in ISO 8601 format. |
Bmi |
Calculated Body Mass Index, or BMI. |
Fat |
Body fat percentage. |
Weight |
Body weight in kilograms. |
Source |
The source of the data, see Sources below. |
Sources
Fitbit can accept weight data from different sources, defined as follows:
-
API: The weight and/or body fat data originated from a 3rd party integration using the Web API, the data was manually entered into the Fitbit mobile or web application, or the data recorded by a predefined scale was manually edited.
- Aria: The weight and/or body fat data originated from an Aria or Aria 2 scale.
- AriaAir: The weight and/or body fat data originated from an Aria Air scale.
- Withings: The weight and/or body fat data originated from a Withings scale.
Sample CSV Export
FitbitBodyWeightLogKey,ParticipantID,ParticipantIdentifier,InsertedDate,DateTime,LogID,Bmi,Fat,Weight,Source
2044f35e3126ee11a197d4d853adda9e-1706918399000,2044f35e-3126-ee11-a197-d4d853adda9e,adfb630,2024-02-13T21:30:41Z,2024-02-02T23:59:59,1706918399000,24.11,22,76.2,API
Sample JSON Export
{
"FitbitBodyWeightLogKey": "2044f35e3126ee11a197d4d853adda9e-1706918399000",
"ParticipantID": "2044f35e-3126-ee11-a197-d4d853adda9e",
"ParticipantIdentifier": "adfb630",
"InsertedDate": "2024-02-13T21:30:41Z",
"LogID": "1706918399000",
"DateTime": "2024-02-02T23:59:59",
"Bmi": 24.11,
"Fat": 22.0,
"Weight": 76.2,
"Source": "API"
}
Was this article helpful?