OPEN SOURCE

Build with your health data

VitaVault exports Apple Health data in two formats: CSV (for spreadsheets) and JSON (for code and AI tools). The export toolkit is open source.

Two export formats

Each export gives you the same Apple Health samples in a different shape. Exports are unlimited for everyone. Free exports cover 5 metrics for the last 7 days; Premium covers every metric and your full history.

1. JSON (for developers and AI tools)

One record per Apple Health sample, with its type, value, unit, start and end time, and source. Easy to parse in any language. Trimmed here: the real file also carries device and app details, and every record in the range.

export.json

{
  "schemaVersion": "2.0",
  "syncTimestamp": "2026-02-17T12:00:00.000Z",
  "exportRangeStart": "2026-02-11T00:00:00.000Z",
  "exportRangeEnd": "2026-02-17T11:00:00.000Z",
  "includedTypes": ["stepCount", "heartRate"],
  "recordCount": 2,
  "records": [
    {
      "id": "8C1E0F52-1B7A-4C2D-9E61-5A0D2F3B7C11",
      "type": "stepCount",
      "value": 812,
      "unit": "count",
      "startDate": "2026-02-17T10:00:00.000Z",
      "endDate": "2026-02-17T11:00:00.000Z",
      "timezoneOffsetMinutes": -300,
      "sourceName": "Apple Watch",
      "schemaVersion": "2.0"
    },
    {
      "id": "D47A93E0-6F2B-4E85-A1C9-0B3E8F2D5A64",
      "type": "heartRate",
      "value": 72,
      "unit": "bpm",
      "startDate": "2026-02-17T10:41:12.000Z",
      "endDate": "2026-02-17T10:41:12.000Z",
      "timezoneOffsetMinutes": -300,
      "sourceName": "Apple Watch",
      "schemaVersion": "2.0"
    }
  ]
}

2. CSV (for spreadsheets)

Opens directly in Excel, Google Sheets, or Numbers. One row per Apple Health sample, with the same fields as the JSON records. Filter by type to chart any metric over time.

export.csv

id,type,value,categoryValue,unit,startDate,endDate,timezoneOffsetMinutes,sourceName,sourceBundle,sourceVersion,sourceProductType,deviceName,deviceManufacturer,deviceModel,deviceSoftwareVersion,metadata
8C1E0F52-1B7A-4C2D-9E61-5A0D2F3B7C11,stepCount,812,,count,2026-02-17T10:00:00.000Z,2026-02-17T11:00:00.000Z,-300,Apple Watch,,,,,,,,
D47A93E0-6F2B-4E85-A1C9-0B3E8F2D5A64,heartRate,72,,bpm,2026-02-17T10:41:12.000Z,2026-02-17T10:41:12.000Z,-300,Apple Watch,,,,,,,,

Use with any AI

Upload your JSON or CSV file, or paste it in, and ask. Here are some prompts to get started.

ChatGPT

Paste your export and ask for actionable health recommendations.

Prompt

Analyze my health trends and give me 3 actionable recommendations.

Claude

Upload your JSON file and ask for a comprehensive health report.

Prompt

Review this JSON and create a comprehensive health report with risks, trends, and next steps.

Gemini

Use Google AI Studio with your health data for personalized insights.

Prompt

Summarize my health metrics, identify outliers, and suggest a one-week improvement plan.

Your Own App

Parse JSON/CSV in Python, JavaScript, or any language. Build dashboards, alerts, or integrations.

JavaScript

const steps = data.records
  .filter(r => r.type === "stepCount")
  .reduce((sum, r) => sum + (r.value ?? 0), 0);
console.log(`Steps in this export: ${steps}`);

Open Source Toolkit

Everything you need to build on VitaVault exports.

Export schema documentation
Python parsing scripts
Example AI prompts
CSV converter utility

Star us on GitHub

VitaVault stores your health data on your iPhone, and there is no public API. The one exception is OpenClaw sync through VitaVault Cloud, which is off unless you turn it on: your OpenClaw agent then fetches your synced data from our server with a connection key unique to your device. Otherwise, your data leaves your phone only when you export it or use an AI feature or scan.