Recovery Tools

Four tools for accessing your recovery scores, HRV, and readiness metrics.

get-recovery-collection

Retrieve a paginated list of recovery records with optional date filtering.

Parameters

Parameter	Type	Required	Default	Description
start_date	string	No	-	Start date in ISO 8601 format
end_date	string	No	-	End date in ISO 8601 format
limit	number	No	25	Maximum records to return (max: 25)

Example Questions

• "Show me my recovery scores from last week"
• "Get all recovery records from December"
• "What's my HRV been looking like?"

Response Fields

Field	Description
cycle_id	Associated daily cycle ID
score.recovery_score	Overall recovery percentage (0-100)
score.resting_heart_rate	RHR in beats per minute
score.hrv_rmssd_milli	Heart rate variability in milliseconds
score.spo2_percentage	Blood oxygen saturation
score.skin_temp_celsius	Skin temperature

---

get-recovery-by-cycle-id

Get recovery data for a specific physiological cycle.

Parameters

Parameter	Type	Required	Description
cycle_id	number	Yes	The cycle ID to get recovery for

Example Questions

• "Get recovery details for cycle 67890"
• "Show me the recovery score for that specific day"

---

get-recent-recovery

Convenience tool to get recovery records from the last N days.

Parameters

Parameter	Type	Required	Default	Description
days	number	No	7	Number of days to look back

Example Questions

• "How has my recovery been this week?"
• "Show my recovery for the past 2 weeks"
• "What's my recent HRV trend?"

---

get-recovery-summary

Get aggregated recovery metrics and averages for a date range.

Parameters

Parameter	Type	Required	Description
start_date	string	Yes	Start date in ISO 8601 format
end_date	string	Yes	End date in ISO 8601 format

Example Questions

• "What's my average recovery score this month?"
• "How's my HRV trending?"
• "Summarize my recovery for December"

Response Fields

Field	Description
period	Date range and number of days
totals.recovery_records	Number of recovery records
averages.recovery_score	Average recovery percentage
averages.resting_heart_rate	Average RHR
averages.hrv_rmssd_milli	Average HRV
averages.spo2_percentage	Average blood oxygen

---

Understanding Recovery Metrics

Recovery Score

Range	Color	Meaning
67-100%	Green	Body is recovered, ready for strain
34-66%	Yellow	Moderate recovery, consider lighter activity
0-33%	Red	Body needs recovery, prioritize rest

HRV (Heart Rate Variability)

HRV is measured in milliseconds (hrv_rmssd_milli). It represents the variation between heartbeats.

• Higher HRV generally indicates better recovery and cardiovascular fitness
• Lower HRV may indicate incomplete recovery, stress, or illness
• Personal baselines vary significantly - compare to your own trends

Resting Heart Rate

• Lower RHR generally indicates better cardiovascular fitness
• Elevated RHR can signal incomplete recovery, illness, or stress
• Track trends over time rather than individual readings

Blood Oxygen (SpO2)

Normal ranges are typically 95-100%. Lower readings may indicate:

• High altitude
• Respiratory issues
• Sleep apnea (when measured during sleep)

Skin Temperature

Deviations from your baseline can indicate:

• Illness (elevated temperature)
• Hormonal changes
• Environmental factors

Calibration

When user_calibrating is true, WHOOP is still learning your baseline metrics. This typically takes 4-7 days of wear.