Data Logs | Sahha Docs

Introduction

Raw health data, unfiltered. Data Logs provide granular, timestamped samples directly from HealthKit and Health Connect—ideal for research, clinical studies, and custom analytics.

Need processed data instead?

Most use cases are better served by Biomarkers—deduplicated, aggregated, and ready to use. Use Data Logs only when you need the raw samples.

Key Features

Raw & Unfiltered

Direct access to granular health samples for research and analysis

Multi-Source

Data from HealthKit, Health Connect, and wearables in one stream

Real-time Streaming

Receive data as it's recorded via webhooks

Research-Grade

Timestamped, source-attributed records for clinical use

Complete Provenance

Know exactly which device and app recorded each sample

Flexible Filtering

Filter by log type, data type, or time range

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
exercisesession*	minute	Duration spent doing specified exercise type. See all supported exercise types	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

Nutrition Logs

Sourced from HealthKit and Health Connect dietary entries. Values are per-record intake amounts as logged in the source app, not daily aggregates.

Data Type	Unit	Description	Requires Wearable
energy_intake	kcal	Total energy consumed from food and beverages.	No
water_intake	L	Volume of water consumed.	No
protein_intake	g	Protein consumed.	No
fat_intake	g	Total dietary fat consumed.	No
fat_saturated_intake	g	Saturated fat consumed.	No
fat_monounsaturated_intake	g	Monounsaturated fat consumed.	No
fat_polyunsaturated_intake	g	Polyunsaturated fat consumed.	No
fat_trans_intake	g	Trans fat consumed. Android only.	No
cholesterol_intake	mg	Dietary cholesterol consumed.	No
carbohydrate_intake	g	Total carbohydrates consumed.	No
sugar_intake	g	Sugars consumed.	No
fiber_intake	g	Dietary fiber consumed.	No
vitamin_a_intake	µg	Vitamin A consumed.	No
vitamin_c_intake	mg	Vitamin C consumed.	No
vitamin_d_intake	µg	Vitamin D consumed.	No
vitamin_e_intake	mg	Vitamin E consumed.	No
vitamin_k_intake	µg	Vitamin K consumed.	No
thiamin_intake	mg	Thiamin (vitamin B1) consumed.	No
riboflavin_intake	mg	Riboflavin (vitamin B2) consumed.	No
niacin_intake	mg	Niacin (vitamin B3) consumed.	No
pantothenic_acid_intake	mg	Pantothenic acid (vitamin B5) consumed.	No
vitamin_b6_intake	mg	Vitamin B6 consumed.	No
biotin_intake	µg	Biotin (vitamin B7) consumed.	No
folate_intake	µg	Folate (vitamin B9) consumed.	No
vitamin_b12_intake	µg	Vitamin B12 consumed.	No
calcium_intake	mg	Calcium consumed.	No
iron_intake	mg	Iron consumed.	No
magnesium_intake	mg	Magnesium consumed.	No
phosphorus_intake	mg	Phosphorus consumed.	No
potassium_intake	mg	Potassium consumed.	No
sodium_intake	mg	Sodium consumed.	No
zinc_intake	mg	Zinc consumed.	No
chloride_intake	mg	Chloride consumed.	No
copper_intake	mg	Copper consumed.	No
manganese_intake	mg	Manganese consumed.	No
chromium_intake	µg	Chromium consumed.	No
molybdenum_intake	µg	Molybdenum consumed.	No
selenium_intake	µg	Selenium consumed.	No
iodine_intake	µg	Iodine consumed.	No
caffeine_intake	mg	Caffeine consumed.	No

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_session	minute	Parent record for grouping sleep data.	Yes
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.

logType string

Log category: activity, sleep, heart, body, energy, nutrition, etc.

dataType string

Specific data type (e.g., steps, heart_rate)

externalId string

The identifier for the profile that sent the log

receivedAtUtc datetime

UTC timestamp when the log was received

dataLogs DataLog[]

Array of individual data samples

Example Response

JSON

[
	{
		"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": {}
			}
		]
	}
]

Object

DataLog

Each entry in the dataLogs array contains:

id UUID

Unique identifier for this sample

parentId UUID nullable

Parent record ID for hierarchical data

value float

The recorded measurement value

unit string

Unit of measurement (e.g., count, bpm)

source string

Device or app that recorded the data

recordingMethod string

How the data was captured (automatic, manual, etc.)

deviceType string

Device model identifier

startDateTime datetime

When the measurement started (ISO 8601)

endDateTime datetime

When the measurement ended (ISO 8601)

additionalProperties object

Extra metadata specific to certain log types

FAQ

What's the difference between Data Logs and Biomarkers? +

Data Logs are raw samples with full provenance. Biomarkers are processed, deduplicated, and aggregated—ready for most use cases.

How do I receive Data Logs? +

Subscribe to Data Log webhooks in the dashboard. Logs are streamed in real-time as they're recorded.

Can I filter by data type? +

Yes. Configure your webhook to receive only specific log types (e.g., only sleep or heart data).

Getting Started

Data Logs are delivered exclusively via webhooks for real-time streaming.

Webhooks

Stream raw health samples as they're recorded

Dashboard

Configure webhook endpoints and select log types

Support

For help with Data Logs, reach out in the Slack community or contact support@sahha.ai.