JSON Export Format Overview

When you export your health data in JSON format, all data is organized into a single file with a structured format that makes it easy to import into databases, analyze programmatically, or integrate with other applications.

File Structure

All exported data is contained within a data object that includes arrays for each supported data type:

{
  "data": {
    "metrics": [],
    "workouts": [],
    "stateOfMind": [],
    "medications": [],
    "symptoms": [],
    "cycleTracking": [],
    "ecg": [],
    "heartRateNotifications": []
  }
}

Data Types

The JSON export format supports the following data types:

Health Metrics (metrics)

An array containing all your health metric data, such as step count, heart rate, blood pressure, sleep, and more. Each metric follows a common structure with the metric name, units, and an array of data points.

Learn more: Health Metrics Documentation

Workouts (workouts)

An array containing all your workout sessions, including activity type, duration, distance, calories burned, heart rate data, and route information (if available).

Learn more: Workouts Documentation

State of Mind (stateOfMind)

An array containing your mood and mental state entries, including valence ratings, labels, and associations.

Learn more: State of Mind Documentation

Medications (medications)

An array containing your medication records, including medication names, dosages, scheduled times, and adherence information.

Learn more: Medications Documentation

Symptoms (symptoms)

An array containing symptom entries with start and end times, severity, and source information.

Learn more: Symptoms Documentation

Cycle Tracking (cycleTracking)

An array containing menstrual cycle data, including flow, cervical mucus quality, basal body temperature, and ovulation test results.

Learn more: Cycle Tracking Documentation

ECG (ecg)

An array containing electrocardiogram (ECG) readings from compatible devices, including classifications, heart rate measurements, and voltage data.

Learn more: ECG Documentation

Heart Rate Notifications (heartRateNotifications)

An array containing high and low heart rate notification events, including thresholds and detailed heart rate measurements during events.

Learn more: Heart Rate Notifications Documentation

Date Format

All dates in the JSON export use the following format:

• Format: yyyy-MM-dd HH:mm:ss Z
• Example: 2024-02-06 14:30:00 -0800

This format includes:

• Date (year-month-day)
• Time (24-hour format: hours:minutes:seconds)
• Timezone offset

Why Use JSON Format?

JSON format is ideal for:

• Database storage - Easy to import into databases like PostgreSQL, MySQL, or MongoDB
• Data analysis - Compatible with data analysis tools and programming languages
• Application integration - Simple to parse and use in custom applications
• Detailed data - Preserves complex nested structures for data types like sleep phases and ECG readings

Getting Started

1. Export your data using Manual Export or set up an Automation
2. Select JSON format when configuring your export
3. Choose Export Version 2 for the most current data structure (recommended)
4. Review the documentation for each data type to understand the structure

Related Documentation

• Manual Export Guide - Learn how to export your data
• Automations Overview - Set up automated exports
• Individual data type documentation (linked above)