Endpoints
Complete reference for all available API endpoints.
https://api.sonarhealth.co/v1
Users
Create and manage users on your Sonar account.
5 endpointsDevices
Connect, list, and disconnect wearable devices for a user.
3 endpointsDaily
Aggregated daily health metrics — one value per metric per day.
1 endpointTimeseries
Intraday samples — heart rate, HRV, stress, blood oxygen, steps, active calories.
1 endpointSleep
Per-session sleep data — duration, stages, efficiency, and overnight vitals.
1 endpointWorkouts
Per-session workout data — sport type, duration, distance, heart rate zones.
1 endpointScores
Computed health scores (0–100) — Recovery, Strain, Sleep, Stress, Nutrition, Energy Reserve.
2 endpointsEvents
Cursor-based events log — poll for data updates, score changes, and device connections.
1 endpointWebhooks
Register endpoints to receive real-time notifications when data or scores update.
4 endpointsAuth
Generate scoped tokens for frontends and mobile SDKs.
3 endpoints
Sonar