Sonar
Once data flows in from connected devices, Sonar normalizes it. Devices report data in different formats, units, and naming conventions — Sonar turns all of it into a unified schema of 70+ metrics. Same IDs, same units, same schema, regardless of whether the data came from Apple Health, a Garmin, or a nutrition app. Some metrics come directly from devices, some are derived from workout sessions, and some are computed by Sonar.
Every metric has a metric_id — the identifier you use in API requests. Pass them directly when querying health data:
GET /v1/users/{user_id}/daily?metrics=steps,resting_heart_rate,heart_rate_variability
All metrics use metric units by default (kg, km, °C). You can switch to imperial units on any individual API call — see API Conventions for details.
Activity
14 metrics tracking movement, daily activity, and workout distances.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Steps | steps |
count | Total step count |
| Distance | distance |
km | Total distance traveled |
| Exercise | exercise |
min | Total exercise duration |
| Flights Climbed | flights_climbed |
flights | Flights of stairs climbed |
| Stand Minutes | stand_time |
min | Standing minutes |
| Stand Hours | stand_hours |
hours | Standing hours |
| Mindfulness | mindfulness |
min | Mindfulness or meditation duration |
Workout Distances
When a user completes a workout, the device reports a session with a type (running, cycling, etc.) and distance. Sonar maps these to sport-specific metric_ids automatically.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Walking | walking |
km | Walking distance |
| Indoor Walking | indoor_walking |
km | Indoor walking distance |
| Running | running |
km | Running distance |
| Indoor Running | indoor_running |
km | Indoor running distance |
| Cycling | cycling |
km | Cycling distance |
| Indoor Cycling | indoor_cycling |
km | Indoor cycling distance |
| Swimming | swimming |
m | Swimming distance |
See which workout types each provider supports in the provider matrix below.
Sleep
16 metrics covering sleep duration, stages, and overnight vitals.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Time Asleep | asleep |
min | Total sleep duration |
| Time Awake | time_awake |
min | Time awake during sleep period |
| Light Sleep | light_sleep |
min | Light sleep stage duration |
| Deep Sleep | deep_sleep |
min | Deep sleep stage duration |
| REM | REM |
min | REM sleep stage duration |
| Time in Bed | time_in_bed |
min | Total time in bed |
| Restorative Sleep | restorative_sleep |
min | Restorative (deep + REM) sleep |
| Sleep Efficiency | sleep_efficiency |
% | Ratio of sleep to time in bed |
| Sleep HRV | sleep_heart_rate_variability |
ms | Heart rate variability during sleep |
| Sleep Heart Rate | sleep_heart_rate |
bpm | Average heart rate during sleep |
| Sleep Respiratory Rate | sleep_respiratory_rate |
rpm | Breathing rate during sleep |
| Sleep Blood Oxygen | sleep_blood_oxygen |
% | SpO2 during sleep |
| Sleep Body Temp | sleep_body_temperature |
°C | Core body temperature during sleep |
| Sleep Skin Temp | sleep_skin_temperature |
°C | Skin temperature during sleep |
| Sleep Wrist Temp | sleep_wrist_temperature |
°C | Wrist temperature during sleep |
| Sleep Bank | sleep_bank |
min | Cumulative sleep surplus/deficit — computed by Sonar |
Vitals
17 metrics covering heart rate, HRV, blood oxygen, blood pressure, and more.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Heart Rate | heart_rate |
bpm | Average heart rate |
| Resting Heart Rate | resting_heart_rate |
bpm | Resting heart rate |
| Walking Heart Rate | walking_heart_rate |
bpm | Heart rate during walking |
| Daytime Heart Rate | daytime_heart_rate |
bpm | Average daytime heart rate |
| Heart Rate Dip | heart_rate_dip |
% | Overnight heart rate dip |
| HRV | heart_rate_variability |
ms | Heart rate variability (default) |
| Daytime HRV | daytime_heart_rate_variability |
ms | HRV measured during daytime |
| HRV (RMSSD) | heart_rate_variability_rmssd |
ms | HRV — RMSSD method |
| HRV (SDNN) | heart_rate_variability_sdnn |
ms | HRV — SDNN method |
| Respiratory Rate | respiratory_rate |
rpm | Breathing rate |
| VO2 Max | vo2_max |
mL/kg/min | Maximum oxygen consumption |
| Blood Oxygen | blood_oxygen |
% | Blood oxygen saturation (SpO2) |
| Blood Glucose | blood_glucose |
mg/dL | Blood glucose level |
| Systolic | systolic |
mmHg | Systolic blood pressure |
| Diastolic | diastolic |
mmHg | Diastolic blood pressure |
| Ketones | ketones |
mmol/L | Blood ketone level |
| Hearing | hearing |
dB | Environmental sound level |
Body Composition
5 metrics for weight, body fat, and body measurements.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Weight | weight |
kg | Body weight |
| Height | height |
cm | Height |
| Body Fat | body_fat_percentage |
% | Body fat percentage |
| BMI | body_mass_index |
kg/m² | Body mass index |
| Lean Body Mass | lean_body_mass |
kg | Lean body mass |
Energy
4 metrics tracking energy balance.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Active Calories | active_calories |
kcal | Calories burned through activity |
| Resting Energy | resting_energy |
kcal | Basal metabolic calories |
| Total Calories | total_calories |
kcal | Total daily energy expenditure |
| Calories Consumed | calories_consumed |
kcal | Caloric intake |
Nutrition
7 metrics tracking macronutrient and hydration intake.
| Metric | metric_id |
Unit | Description |
|---|---|---|---|
| Carbohydrates | carbohydrates |
g | Carbohydrate intake |
| Protein | protein |
g | Protein intake |
| Fat | fat |
g | Fat intake |
| Fiber | fiber |
g | Dietary fiber intake |
| Sodium | sodium |
mg | Sodium intake |
| Water | water |
mL | Water intake |
| Alcohol | alcohol_consumption |
g | Alcohol consumption |
Scores
8 health scores computed by Sonar from the metrics above — not reported by any device. Each score ranges from 0–100 and recomputes in real time as new data arrives. See Health Scores for methodology, factor breakdowns, and delivery options.
| Score | metric_id |
Key inputs |
|---|---|---|
| Recovery | recovery_score |
HRV, resting heart rate, sleep quality |
| Strain | strain_score |
Heart rate zones, active calories, exercise duration |
| Sleep | sleep_score |
Duration, stages (deep/REM/light), efficiency |
| Stress | stress_score |
HRV patterns, heart rate, activity context |
| Inactive Stress | inactive_stress_score |
Stress signal during periods of inactivity |
| Sleep Stress | sleep_stress_score |
Stress signal during sleep |
| Nutrition | nutrition_score |
Macronutrients, caloric intake, hydration |
| Energy Reserve | energy_reserve_score |
Recovery trend, sleep bank, strain balance |
Glossary
Reference for abbreviated column headers in the provider matrix:
| Abbreviation | Meaning |
|---|---|
| HR | Heart Rate (beats per minute) |
| HRV | Heart Rate Variability — beat-to-beat variation in heart rhythm, a marker of autonomic nervous system activity |
| RMSSD | Root Mean Square of Successive Differences — an HRV calculation method that emphasizes parasympathetic (rest-and-recovery) activity. Most common in consumer wearables |
| SDNN | Standard Deviation of NN intervals — an HRV calculation method that reflects overall autonomic balance. Currently reported by Apple Health |
| SpO2 | Blood oxygen saturation — percentage of hemoglobin carrying oxygen (normal: 95–100%) |
| VO2 Max | Maximum rate of oxygen consumption during exercise — a key measure of cardiorespiratory fitness (mL/kg/min) |
| REM | Rapid Eye Movement sleep — the sleep stage associated with dreaming and memory consolidation |
| BMI | Body Mass Index — weight (kg) divided by height squared (m²) |
| Resp Rate | Respiratory rate — breaths per minute |
Provider Availability
Every provider delivers a different slice of the catalog. The matrix below shows exactly which metrics each of the most popular providers supports. Sonar supports 60+ providers in total — Mobile SDK health stores and Cloud API integrations. Hover over a column header to see the metric_id. For how each provider connects, see Device Connectivity.
| Provider | Steps | Distance | Exercise | Flights | Stand Min | Stand Hrs | Mindful |
|---|---|---|---|---|---|---|---|
| Mobile SDK | |||||||
| Apple Health 7/7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Health Connect 4/7 | ✓ | ✓ | — | ✓ | — | — | ✓ |
| Samsung Health 3/7 | ✓ | ✓ | — | ✓ | — | — | — |
| Cloud API — Wearables & Rings | |||||||
| Garmin 4/7 | ✓ | ✓ | ✓ | ✓ | — | — | — |
| Fitbit 4/7 | ✓ | ✓ | ✓ | ✓ | — | — | — |
| Oura Ring 2/7 | ✓ | ✓ | — | — | — | — | — |
| Whoop 3/7 | ✓ | ✓ | ✓ | — | — | — | — |
| Polar 4/7 | ✓ | ✓ | ✓ | ✓ | — | — | — |
| Withings 3/7 | ✓ | ✓ | — | ✓ | — | — | — |
| Zepp (Amazfit) 4/7 | ✓ | ✓ | ✓ | ✓ | — | — | — |
| Cloud API — Fitness Platforms | |||||||
| Strava 3/7 | ✓ | ✓ | ✓ | — | — | — | — |
| Peloton 1/7 | — | — | ✓ | — | — | — | — |
| Provider | Asleep | Awake | Light | Deep | REM | In Bed | Restore | Effic. | Sleep HR | Sleep HRV | Sleep RR | Sleep SpO2 | Body Temp | Skin Temp | Wrist Temp |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Mobile SDK | |||||||||||||||
| Apple Health 9/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — | — | — | — | — | ✓ |
| Health Connect 9/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — | — | — | — | ✓ | — |
| Samsung Health 9/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — | — | — | — | ✓ | — |
| Cloud API — Wearables & Rings | |||||||||||||||
| Garmin 14/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Fitbit 13/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | — |
| Oura Ring 13/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | — |
| Whoop 12/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — | ✓ | — |
| Polar 8/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — | — | — | — | — | — |
| Withings 13/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | — |
| Zepp (Amazfit) 8/15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — | — | — | — | — | — |
| Provider | HR | Rest HR | Walk HR | Day HR | HR Dip | HRV | Day HRV | RMSSD | SDNN | Resp Rate | VO2 Max | SpO2 | Glucose | Systolic | Diastolic | Ketones | Hearing |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Mobile SDK | |||||||||||||||||
| Apple Health 13/17 | ✓ | ✓ | ✓ | ✓ | — | ✓ | — | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ |
| Health Connect 10/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | — |
| Samsung Health 5/17 | ✓ | — | — | — | — | — | — | — | — | — | — | ✓ | ✓ | ✓ | ✓ | — | — |
| Cloud API — Wearables & Rings | |||||||||||||||||
| Garmin 7/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | ✓ | ✓ | ✓ | — | — | — | — | — |
| Fitbit 6/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | ✓ | — | ✓ | — | — | — | — | — |
| Oura Ring 6/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | ✓ | — | ✓ | — | — | — | — | — |
| Whoop 5/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | ✓ | — | — | — | — | — | — | — |
| Polar 4/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | — | — | — | — | — | — | — | — |
| Withings 5/17 | ✓ | ✓ | — | — | — | — | — | — | — | — | — | ✓ | — | ✓ | ✓ | — | — |
| Zepp (Amazfit) 5/17 | ✓ | ✓ | — | — | — | ✓ | — | ✓ | — | — | — | ✓ | — | — | — | — | — |
| Cloud API — Fitness Platforms | |||||||||||||||||
| Strava 1/17 | ✓ | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
| Peloton 1/17 | ✓ | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
| Cloud API — Health Monitors | |||||||||||||||||
| FreeStyle Libre 1/17 | — | — | — | — | — | — | — | — | — | — | — | — | ✓ | — | — | — | — |
| Provider | Weight | Height | Body Fat | BMI | Lean Mass |
|---|---|---|---|---|---|
| Mobile SDK | |||||
| Apple Health 5/5 | ✓ | ✓ | ✓ | ✓ | ✓ |
| Health Connect 4/5 | ✓ | ✓ | ✓ | — | ✓ |
| Samsung Health 4/5 | ✓ | ✓ | ✓ | — | ✓ |
| Cloud API — Wearables & Rings | |||||
| Garmin 5/5 | ✓ | ✓ | ✓ | ✓ | ✓ |
| Fitbit 5/5 | ✓ | ✓ | ✓ | ✓ | ✓ |
| Withings 5/5 | ✓ | ✓ | ✓ | ✓ | ✓ |
| Cloud API — Health Monitors | |||||
| Renpho 4/5 | ✓ | — | ✓ | ✓ | ✓ |
| Provider | Active Cal | Rest Cal | Total Cal | Consumed |
|---|---|---|---|---|
| Mobile SDK | ||||
| Apple Health 3/4 | ✓ | ✓ | — | ✓ |
| Health Connect 4/4 | ✓ | ✓ | ✓ | ✓ |
| Samsung Health 4/4 | ✓ | ✓ | ✓ | ✓ |
| Cloud API — Wearables & Rings | ||||
| Garmin 4/4 | ✓ | ✓ | ✓ | ✓ |
| Fitbit 4/4 | ✓ | ✓ | ✓ | ✓ |
| Oura Ring 2/4 | ✓ | — | ✓ | — |
| Whoop 2/4 | ✓ | — | ✓ | — |
| Polar 3/4 | ✓ | ✓ | ✓ | — |
| Withings 3/4 | ✓ | ✓ | ✓ | — |
| Zepp (Amazfit) 3/4 | ✓ | ✓ | ✓ | — |
| Cloud API — Fitness Platforms | ||||
| Strava 1/4 | ✓ | — | — | — |
| Peloton 1/4 | ✓ | — | — | — |
| Cloud API — Nutrition Apps | ||||
| MyFitnessPal 1/4 | — | — | — | ✓ |
| Cronometer 1/4 | — | — | — | ✓ |
| Provider | Carbs | Protein | Fat | Fiber | Sodium | Water | Alcohol |
|---|---|---|---|---|---|---|---|
| Mobile SDK | |||||||
| Apple Health 7/7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Health Connect 6/7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Samsung Health 6/7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Cloud API — Nutrition Apps | |||||||
| MyFitnessPal 6/7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Cronometer 6/7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| Provider | Running | Walking | Cycling | Swimming |
|---|---|---|---|---|
| Mobile SDK | ||||
| Apple Health 4/4 | ✓ | ✓ | ✓ | ✓ |
| Health Connect 4/4 | ✓ | ✓ | ✓ | ✓ |
| Samsung Health 4/4 | ✓ | ✓ | ✓ | ✓ |
| Cloud API — Wearables & Rings | ||||
| Garmin 4/4 | ✓ | ✓ | ✓ | ✓ |
| Fitbit 4/4 | ✓ | ✓ | ✓ | ✓ |
| Oura Ring 2/4 | ✓ | ✓ | — | — |
| Whoop 4/4 | ✓ | ✓ | ✓ | ✓ |
| Polar 4/4 | ✓ | ✓ | ✓ | ✓ |
| Withings 2/4 | ✓ | ✓ | — | — |
| Zepp (Amazfit) 4/4 | ✓ | ✓ | ✓ | ✓ |
| Cloud API — Fitness Platforms | ||||
| Strava 4/4 | ✓ | ✓ | ✓ | ✓ |
| Peloton 2/4 | ✓ | — | ✓ | — |
HRV methodology: Apple Health provides both SDNN and RMSSD. Health Connect and all Cloud API devices provide RMSSD. Use heart_rate_variability for the provider's default method, or request a specific method with heart_rate_variability_rmssd / heart_rate_variability_sdnn.
Overnight sleep vitals (sleep-specific HR, HRV, respiratory rate, SpO2, and temperature) are available from Cloud API wearables that compute them on-device — primarily Garmin, Fitbit, Oura, Whoop, and Withings.
Proxy devices — Some apps write directly to Apple Health or Health Connect (MacroFactor, Dexcom, Calm, Headspace, Lose It!, and others). If your user has the Mobile SDK, their data flows in automatically.
When multiple devices overlap, Sonar deduplicates automatically — see Data Model — Multi-Device Deduplication.