Data Logs

Data Logs offer a detailed and unprocessed stream of data across various health metrics. This raw data is useful for in-depth health analysis, research, and discovery. It acts as the foundational layer for advanced applications.

List of Data Logs

Below are the key data types captured in Data Logs, categorized by their respective health aspects. The logs can be streamed via webhooks for real-time data reception.

Activity Logs

Data Type	Unit	Description	Requires Wearable
exercise_time	minute	Duration of physical exercise.	No
floors_climbed	count	Number of floors climbed.	No
stand_time	minute	Time spent standing.	No
steps	count	Total steps taken.	No

Blood Logs

Data Type	Unit	Description	Requires Wearable
blood_glucose	mg/dL	Glucose levels in the blood.	Yes
blood_pressure_diastolic	mmHg	Diastolic blood pressure.	Yes
blood_pressure_systolic	mmHg	Systolic blood pressure.	Yes

Body Logs

Data Type	Unit	Description	Requires Wearable
body_fat	percent	Percentage of body fat.	Yes
body_mass_index	count	Body Mass Index (BMI).	No
lean_body_mass	kg	Weight of lean body mass.	Yes
weight	kg	Total body weight.	No

Device Logs

Data Type	Unit	Description	Requires Wearable
device_lock	boolean	Indicates if the device is locked.	No

Energy Logs

Data Type	Unit	Description	Requires Wearable
active_energy_burned	kcal	Calories burned through activity.	No
basal_energy_burned	kcal	Calories burned at rest.	No
time_in_daylight	minute	Time spent in natural daylight.	No

Exercise Logs

Data Type	Unit	Description	Requires Wearable
exercise_session_*	minute	Duration spent doing specified exercise type	No
exercise_session_biking	minute	Duration spent cycling or biking	No
exercise_session_running	minute	Duration spent running or jogging	No
exercise_session_walking	minute	Duration spent walking for exercise	No

Heart Logs

Data Type	Unit	Description	Requires Wearable
heart_rate	bpm	Beats per minute.	Yes
heart_rate_variability	ms	Variation in intervals between heartbeats.	Yes
heart_rate_variability_sdnn	ms	Standard deviation of NN intervals.	Yes
resting_heart_rate	bpm	Heart rate at rest.	Yes
walking_heart_rate_average	bpm	Average heart rate while walking.	Yes

Oxygen Logs

Data Type	Unit	Description	Requires Wearable
oxygen_saturation	percent	Percentage of oxygen-saturated hemoglobin.	Yes
respiratory_rate	bps	Breaths per second.	Yes
vo2_max	ml/kg/min	Maximum rate of oxygen consumption during exercise.	Yes

Sleep Logs

Data Type	Unit	Description	Requires Wearable
sleep_stage_awake	minute	Duration in awake stage.	Yes
sleep_stage_deep	minute	Duration in deep sleep stage.	Yes
sleep_stage_in_bed	minute	Duration in bed, not necessarily asleep.	No
sleep_stage_light	minute	Duration in light sleep stage.	Yes
sleep_stage_rem	minute	Duration in REM sleep stage.	Yes
sleep_stage_sleeping	minute	Duration spent asleep/sleeping.	No

Temperature Logs

Data Type	Unit	Description	Requires Wearable
basal_body_temperature	degC	Body temperature at rest.	Yes
sleeping_wrist_temperature	degC	Temperature measured at the wrist during sleep	Yes

Browse our comprehensive data dictionary to view all available outputs beyond just data logs.

Output Schema for Data Logs

When you receive data from Data Logs, it comes in a structured format, or "schema," that looks like this:

[
	{
		"logType": "activity",
		"dataType": "steps",
		"externalId": "ext-789",
		"receivedAtUtc": "2023-06-26T12:34:56+00:00",
		"dataLogs": [
			{
				"id": "123e4567-e89b-12d3-a456-426614174003",
				"parentId": null,
				"value": 10000,
				"unit": "count",
				"source": "iPhone X",
				"recordingMethod": "RECORDING_METHOD_AUTOMATICALLY_RECORDED",
				"deviceType": "iPhone13,2",
				"startDateTime": "2023-06-25T00:00:00+00:00",
				"endDateTime": "2023-06-25T23:59:59+00:00",
				"additionalProperties": {
					"": ""
				}
			}
		]
	}
]

• LogType : Specifies the grouping the log fits into such as activity or sleep or energy etc.
• DataType : Specifies what kind of health data is being logged, such as heart_rate or steps.
• ExternalId : The identifier for the profile / device that send the log.
• ReceivedAtUtc : The date and time in UTC that the log was received.
• DataLogs : Contains an array of objects where each object is an individual data log.
• Id :
• Value : The recorded value for the data type.
• Unit : The measurement unit for the Value, like beats per minute (bpm) or count.
• Source : Identifies where or what device the data came from.
• RecordingMethod : Describes how the data was collected, which might not always be specified.
• DeviceType : The specific type or model of the device that recorded the data.
• StartDateTime : When the data recording started, in an ISO 8601 format.
• EndDateTime : When the data recording ended, also in an ISO 8601 format.