Oura Ring

Oura Ring

Auth: API key (oura_api_key in config.md) Base URL: https://api.ouraring.com/v2/usercollection/ Documentation: https://cloud.ouraring.com/v2/docs

Data Available

Metric	Endpoint	Notes
Sleep score	/sleep	0–100; composite of efficiency, duration, timing
Total sleep	/sleep	Minutes; convert to hours for display
Deep sleep	/sleep	Minutes per night
REM sleep	/sleep	Minutes per night
Sleep efficiency	/sleep	Percentage of time in bed spent asleep
Sleep latency	/sleep	Minutes to fall asleep
HRV RMSSD	/sleep	Nightly average in milliseconds
Readiness score	/daily_readiness	0–100; composite recovery metric
Resting heart rate	/daily_readiness	Lowest HR during sleep
Daily steps	/daily_activity	Total steps for the day
Active energy	/daily_activity	Kilocalories burned above BMR
Equivalent walking distance	/daily_activity	km

Configuration

Add to vault/health/config.md:

oura_api_key: YOUR_OURA_API_KEY
oura_lookback_days: 90

To obtain your API key: Oura app → Profile → Personal Access Tokens → Create Token

Key API Calls

# Sleep data
GET https://api.ouraring.com/v2/usercollection/sleep?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
Authorization: Bearer {oura_api_key}

# Readiness data (includes resting HR)
GET https://api.ouraring.com/v2/usercollection/daily_readiness?start_date=YYYY-MM-DD
Authorization: Bearer {oura_api_key}

# Activity data (steps, active energy)
GET https://api.ouraring.com/v2/usercollection/daily_activity?start_date=YYYY-MM-DD
Authorization: Bearer {oura_api_key}

Rate Limits

Oura API v2: 5,000 requests/day per token. The health agent's monthly sync requests approximately 3 API calls per sync (one per endpoint). Well within limits.

Used By

• health-sync-wearable-data — pull nightly sleep, readiness, and activity data
• health-anomaly-watch — flag HRV drops, low readiness streaks, and resting HR elevation
• health-build-wellness-summary — provide data for 30-day and 90-day trend calculations

Vault Output

• vault/health/00_current/wearable-log.csv — daily records appended from API response