Skip to main content

Fitbit Nutrition Export Format

  • Updated

The Fitbit Nutrition data export contains information from participants' food logs, including:

  • Food Log  Daily Summary — A high-level summary of each participant's daily food log.
  • Food Log Items — A detailed breakdown of food log data. Each entry contains information for a particular food item including quantity and nutrition content.
The data in the Fitbit export is obtained through the Fitbit API. The available data will vary based on what the participant logs through Fitbit. See the Fitbit "Get Food Log" documentation for more information about using and interpreting Fitbit data.
 

Food Log Daily Summary

Field Description
FitbitFoodLogDailySummaryKey They key for this entry, in the format "`ParticipantID`-`Date`".
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.
Date The date this summary represents.
GoalsCalories Daily calories goal.
SummaryCalories
 		Total calories logged for this day.
SummaryCarbs Total carbs logged for this day.
SummaryFat Total fat logged for this day.
SummaryFiber Total fiber logged for this day.
SummaryProtein Total protein logged for this day.
SummarySodium
 		Total sodium logged for this day.
SummaryWater Total water consumption logged for this day.

Food Log Items

Field Description
FitbitFoodLogItemKey The key for this food log item, They key for this entry, in the format "`ParticipantID`-`LogID`".
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 Fitbit-assigned ID of this entry.
LogDate The date of this entry.
IsFavorite Whether the user has marked this food as a favorite.
LoggedFoodAccessLevel

The access level of this food item, indicating where the nutrition details are sourced.

  • `PUBLIC`: Foods that are in Fitbit's public food database and are visible to any Fitbit users. Only Fitbit populates this database to avoid spam and duplicate entries.
  • `PRIVATE`: Foods created by a user either on the website or via the Create Food endpoint.
LoggedFoodAmount The amount of food logged, in the LoggedFoodUnit.
LoggedFoodBrand The brand of food logged.
LoggedFoodCalories Calories contained in the consumed amount of food.
LoggedFoodFoodID The ID of the logged food.
LoggedFoodLocale The food's country of origin.
LoggedFoodMealTypeID

The meal type value, as follows:

  • `1`: breakfast
  • `2`: morning snack
  • `3`: lunch
  • `4`: afternoon snack
  • `5`: dinner
  • `6`: after dinner
  • `7`: anytime
LoggedFoodName The name of the logged food.
LoggedFoodUnitID The ID of the logged food unit.
LoggedFoodUnitName The name of the logged food unit, e.g., "cup".
LoggedFoodUnitPlural The plural name of the logged food unit, e.g., "cups".
NutritionalValuesCalories Nutritional value given food item provides in
calories.
NutritionalValuesCarbs Nutritional value given food item provides in
carbohydrates.
NutritionalValuesFat Nutritional value given food item provides in fat.
NutritionalValuesFiber
 		Nutritional value given food item provides in
fiber.
NutritionalValuesProtein

Nutritional value given food item provides in
protein.
NutritionalValuesSodium

Nutritional value given food item provides in
sodium.

Sample CSV Export

FitbitFoodLogDailySummary:

FitbitFoodLogDailySummaryKey,ParticipantID,ParticipantIdentifier,InsertedDate,Date,GoalsCalories,SummaryCalories,SummaryCarbs,SummaryFat,SummaryFiber,SummaryProtein,SummarySodium,SummaryWater
8b16c9264ef1ef11a1f0d4d853adda9e-2025-05-02,8b16c926-4ef1-ef11-a1f0-d4d853adda9e,70ae63b1-4df1-ef11-a1f0-d4d853adda9e,2025-05-07T21:49:14Z,2025-05-02,1617,1016,145.85,32,13,40.57,2030,27986.939453125
8b16c9264ef1ef11a1f0d4d853adda9e-2025-05-05,8b16c926-4ef1-ef11-a1f0-d4d853adda9e,70ae63b1-4df1-ef11-a1f0-d4d853adda9e,2025-05-07T21:49:12Z,2025-05-05,,2037,301.44,74.46,18.07,60.27,3048.71,6996.740234375

FitbitFoodLogItems:

FitbitFoodLogItemKey,ParticipantID,ParticipantIdentifier,InsertedDate,LogID,LogDate,IsFavorite,LoggedFoodAccessLevel,LoggedFoodAmount,LoggedFoodBrand,LoggedFoodCalories,LoggedFoodFoodID,LoggedFoodLocale,LoggedFoodMealTypeID,LoggedFoodName,LoggedFoodUnitID,LoggedFoodUnitName,LoggedFoodUnitPlural,NutritionalValuesCalories,NutritionalValuesCarbs,NutritionalValuesFat,NutritionalValuesFiber,NutritionalValuesProtein,NutritionalValuesSodium
8b16c9264ef1ef11a1f0d4d853adda9e-36353447205,8b16c926-4ef1-ef11-a1f0-d4d853adda9e,70ae63b1-4df1-ef11-a1f0-d4d853adda9e,2025-05-07T21:49:14Z,36353447205,2025-05-02,False,PUBLIC,1,Cheerios,100,748257095,en_US,1,Cheerios Cereal,91,cup,cups,,,,,,
8b16c9264ef1ef11a1f0d4d853adda9e-36353496080,8b16c926-4ef1-ef11-a1f0-d4d853adda9e,70ae63b1-4df1-ef11-a1f0-d4d853adda9e,2025-05-07T21:49:14Z,36353496080,2025-05-02,False,PUBLIC,0.5,,150,81967,en_US,1,"Oats, Rolled, Quick (oatmeal)",91,cup,cups,150,27,3,4,5,0
8b16c9264ef1ef11a1f0d4d853adda9e-36350861073,8b16c926-4ef1-ef11-a1f0-d4d853adda9e,70ae63b1-4df1-ef11-a1f0-d4d853adda9e,2025-05-07T21:49:14Z,36350861073,2025-05-02,False,PUBLIC,10,,6,17222,en_US,2,Coffee,226,oz,oz,6,0.85,0,0,0.57,0

Sample JSON Export

FitbitFoodLogDailySummary:

{
  "FitbitFoodLogDailySummaryKey": "8b16c9264ef1ef11a1f0d4d853adda9e-2025-05-02",
  "ParticipantID": "8b16c926-4ef1-ef11-a1f0-d4d853adda9e",
  "ParticipantIdentifier": "70ae63b1-4df1-ef11-a1f0-d4d853adda9e",
  "InsertedDate": "2025-05-07T21:49:14Z",
  "Date": "2025-05-02",
  "Goals": { "Calories": 1617.0 },
  "Summary": {
    "Calories": 1016.0,
    "Carbs": 145.85,
    "Fat": 32.0,
    "Fiber": 13.0,
    "Protein": 40.57,
    "Sodium": 2030.0,
    "Water": 27986.939453125
  }
}
{
  "FitbitFoodLogDailySummaryKey": "8b16c9264ef1ef11a1f0d4d853adda9e-2025-05-05",
  "ParticipantID": "8b16c926-4ef1-ef11-a1f0-d4d853adda9e",
  "ParticipantIdentifier": "70ae63b1-4df1-ef11-a1f0-d4d853adda9e",
  "InsertedDate": "2025-05-07T21:49:12Z",
  "Date": "2025-05-05",
  "Summary": {
    "Calories": 2037.0,
    "Carbs": 301.44,
    "Fat": 74.46,
    "Fiber": 18.07,
    "Protein": 60.27,
    "Sodium": 3048.71,
    "Water": 6996.740234375
  }
}

FitbitFoodLogItems:

{
  "FitbitFoodLogItemKey": "8b16c9264ef1ef11a1f0d4d853adda9e-36353447205",
  "ParticipantID": "8b16c926-4ef1-ef11-a1f0-d4d853adda9e",
  "ParticipantIdentifier": "70ae63b1-4df1-ef11-a1f0-d4d853adda9e",
  "InsertedDate": "2025-05-07T21:49:14Z",
  "Date": "2025-05-02",
  "LogID": "36353447205",
  "LogDate": "2025-05-02",
  "IsFavorite": false,
  "LoggedFood":
  {
    "AccessLevel": "PUBLIC",
    "Amount": 1.0,
    "Brand": "Cheerios",
    "Calories": 100.0,
    "FoodID": "748257095",
    "Locale": "en_US",
    "MealTypeID": "1",
    "Name": "Cheerios Cereal",
    "Unit": { "ID": "91", "Name": "cup", "Plural": "cups" }
  }
}
{
  "FitbitFoodLogItemKey": "8b16c9264ef1ef11a1f0d4d853adda9e-36353496080",
  "ParticipantID": "8b16c926-4ef1-ef11-a1f0-d4d853adda9e",
  "ParticipantIdentifier": "70ae63b1-4df1-ef11-a1f0-d4d853adda9e",
  "InsertedDate": "2025-05-07T21:49:14Z",
  "Date": "2025-05-02",
  "LogID": "36353496080",
  "LogDate": "2025-05-02",
 "IsFavorite": false,
  "LoggedFood": {
    "AccessLevel": "PUBLIC",
    "Amount": 0.5,
    "Brand": "",
    "Calories": 150.0,
    "FoodID": "81967",
    "Locale": "en_US",
    "MealTypeID": "1",
    "Name": "Oats, Rolled, Quick (oatmeal)",
    "Unit": { "ID": "91", "Name": "cup", "Plural": "cups" }
  },
  "NutritionalValues": {
  "Calories": 150.0,
  "Carbs": 27.0,
  "Fat": 3.0,
  "Fiber": 4.0,
  "Protein": 5.0,
  "Sodium": 0.0
  }
}

Was this article helpful?