Recovery Tools
Four tools for accessing your recovery scores, HRV, and readiness metrics.
whoop-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 |
whoop-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"
whoop-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?"
whoop-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.