Skip to content
  • There are no suggestions because the search field is empty.

Health Connect Nutrition Records Export Format

The Nutrition Records Export contains data about what nutrients were consumed as part of a meal or food item recorded by users.

  • File Prefix: `HealthConnectRecords_Nutrition`
  • Nutrients File Prefix (CSV Format): `HealthConnectRecords_Nutrition_Nutrients`

Data Fields

Field

Description

HealthConnectRecordKey

A unique key for this Health Connect Record, used to cross-reference entries in the Nutrients (CSV) file.

ParticipantIdentifier

The identifier of the participant this record is for. Can be used to cross reference with Participants.

ParticipantID

The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).

MetadataOriginPackageName

The package name of the application that generated this record.

MetadataLastModifiedTime

When the data was last modified (or originally created) by the application, in ISO 8601 format. Is always in UTC.

MetadataClientRecordID

Optional client-supplied record unique data identifier associated with this record.

MetadataClientRecordVersion

Optional client-supplied version associated with this record.

MetadataDeviceManufacturer

Optional client-supplied manufacturer of the device associated with this record.

MetadataDeviceModel

Optional client-supplied model of the device associated with this record.

MetadataDeviceType

Optional client-supplied manufacturer of the device associated with this record.

MetadataRecordingMethod

Whether the record was generated manually or automatically, if known.

InsertedDate

The date MyDataHelps received the data from Health Connect, in ISO 8601 format. Is always in UTC.

StartTime

The time the record started, in ISO 8601 format. Includes timezone offset information. 

StartZoneOffsetSetAtUpload

Whether the time zone offset applied to `StartTime` was derived from the mobile device's zone offset when the data was uploaded. "True" if derived in this way, "False", Null (CSV) or missing property (JSON) if zone offset was provided by Health Connect.

EndTime

The time the record ended, in ISO 8601 format. Includes timezone offset information. 

EndZoneOffsetSetAtUpload

Whether the time zone offset applied to `EndTime` was derived from the mobile device's zone offset when the data was uploaded. "True" if derived in this way, "False", Null (CSV) or missing property (JSON) if zone offset was provided by Health Connect.

Name

The name of this nutrition record.

MealType

The type of meal related to this nutrition record, one of:

  • `"MEAL_TYPE_BREAKFAST"`

  • `"MEAL_TYPE_DINNER"`
  • `"MEAL_TYPE_LUNCH"`
  • `"MEAL_TYPE_SNACK"`

  • `"MEAL_TYPE_UNKNOWN"`

NutrientName

The name of the nutrient consumed.

Value

The amount of the nutrient consumed, in `Type` units.

Type

The unit of measure of nutrient `Value`.

Sample CSV Export

Nutrition Records

HealthConnectRecordKey,ParticipantIdentifier,ParticipantID,MetadataDataOriginPackageName,MetadataLastModifiedTime,MetadataClientRecordID,MetadataClientRecordVersion,MetadataDeviceManufacturer,MetadataDeviceModel,MetadataDeviceType,MetadataRecordingMethod,InsertedDate,StartTime,StartZoneOffsetSetAtUpload,EndTime,EndZoneOffsetSetAtUpload,Name,MealType
d0000000-76d9-4ae7-956a-2e0e17c01fd8,TST123456,1be320d5-57fa-4860-8fa2-033b27038c4e,androidx.health.connect.client.devtool,2025-06-05T15:31:41.139Z,,0,,,TYPE_SMART_DISPLAY,RECORDING_METHOD_MANUAL_ENTRY,2025-10-28T19:56:37Z,2025-06-05T11:01:28.004-04:00,,2025-06-05T11:31:28.004-04:00,,,MEAL_TYPE_BREAKFAST

Nutrition Nutrients

HealthConnectRecordKey,NutrientName,Value,Type
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Biotin,1,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Caffeine,2,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Calcium,3,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Chloride,4,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Cholesterol,5,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Chromium,6,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Copper,7,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,DietaryFiber,8,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Energy,9,KILOCALORIES
d0000000-76d9-4ae7-956a-2e0e17c01fd8,EnergyFromFat,10,KILOCALORIES
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Folate,11,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,FolicAcid,12,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Iodine,13,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Iron,14,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Magnesium,15,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Manganese,16,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Molybdenum,17,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,MonounsaturatedFat,18,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Niacin,19,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,PantothenicAcid,20,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Phosphorus,21,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,PolyunsaturatedFat,22,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Potassium,23,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Protein,24,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Riboflavin,25,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,SaturatedFat,26,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Selenium,27,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Sodium,28,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Sugar,29,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Thiamin,30,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,TotalCarbohydrate,31,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,TotalFat,32,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,TransFat,33,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,UnsaturatedFat,34,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminA,35,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminB12,36,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminB6,37,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminC,38,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminD,39,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminE,40,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,VitaminK,41,GRAMS
d0000000-76d9-4ae7-956a-2e0e17c01fd8,Zinc,42,GRAMS

Sample JSON Export

{
    "HealthConnectRecordKey": "d0000000-76d9-4ae7-956a-2e0e17c01fd8",
  "ParticipantIdentifier": "TST123456",
  "ParticipantID": "1be320d5-57fa-4860-8fa2-033b27038c4e",
    "InsertedDate": "2025-10-28T19:56:37Z",
    "Metadata": {
        "DataOriginPackageName": "androidx.health.connect.client.devtool",
        "LastModifiedTime": "2025-06-05T15:31:41.139Z",
        "ClientRecordVersion": 0,
        "Device": {
            "Type": "TYPE_SMART_DISPLAY"
        },
        "RecordingMethod": "RECORDING_METHOD_MANUAL_ENTRY"
    },
    "StartTime": "2025-06-05T11:01:28.004-04:00",
    "EndTime": "2025-06-05T11:31:28.004-04:00",
    "Name": "",
    "MealType": "MEAL_TYPE_BREAKFAST",
    "Nutrients": [
        {
            "NutrientName": "Biotin",
            "Value": 1.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Caffeine",
            "Value": 2.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Calcium",
            "Value": 3.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Chloride",
            "Value": 4.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Cholesterol",
            "Value": 5.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Chromium",
            "Value": 6.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Copper",
            "Value": 7.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "DietaryFiber",
            "Value": 8.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Energy",
            "Value": 9.0,
            "Type": "KILOCALORIES"
        },
        {
            "NutrientName": "EnergyFromFat",
            "Value": 10.0,
            "Type": "KILOCALORIES"
        },
        {
            "NutrientName": "Folate",
            "Value": 11.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "FolicAcid",
            "Value": 12.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Iodine",
            "Value": 13.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Iron",
            "Value": 14.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Magnesium",
            "Value": 15.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Manganese",
            "Value": 16.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Molybdenum",
            "Value": 17.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "MonounsaturatedFat",
            "Value": 18.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Niacin",
            "Value": 19.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "PantothenicAcid",
            "Value": 20.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Phosphorus",
            "Value": 21.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "PolyunsaturatedFat",
            "Value": 22.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Potassium",
            "Value": 23.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Protein",
            "Value": 24.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Riboflavin",
            "Value": 25.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "SaturatedFat",
            "Value": 26.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Selenium",
            "Value": 27.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Sodium",
            "Value": 28.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Sugar",
            "Value": 29.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Thiamin",
            "Value": 30.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "TotalCarbohydrate",
            "Value": 31.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "TotalFat",
            "Value": 32.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "TransFat",
            "Value": 33.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "UnsaturatedFat",
            "Value": 34.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminA",
            "Value": 35.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminB12",
            "Value": 36.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminB6",
            "Value": 37.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminC",
            "Value": 38.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminD",
            "Value": 39.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminE",
            "Value": 40.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "VitaminK",
            "Value": 41.0,
            "Type": "GRAMS"
        },
        {
            "NutrientName": "Zinc",
            "Value": 42.0,
            "Type": "GRAMS"
        }
    ]
}