Products
Readiness Score
The Readiness Score indicates an individual's preparedness to face daily challenges. It evaluates how well-rested and prepared an individual might be for physical and mental activities. This score can help users understand their optimal performance levels, enabling them to make informed decisions for a productive day ahead.
At-a-Glance: Readiness Score
Aspect | Details |
---|---|
Score type | readiness |
score range | 0.0 - 1.0 |
Possible state s | minimal , low , medium , high |
Contributing factors | sleep_duration , physical_recovery , mental_recovery , sleep_debt , walking_strain_capacity , exercise_strain_capacity , resting_heart_rate , heart_rate_variability |
Supported dataSources | activity , exercise , sleep , vitals |
Latest version | 1.0 |
Status | BETA |
Example JSON Response
{ "id": "a1b2c3d4-e5f6-1234-efgh-ij1234567890", "profileId": "p1q2r3s4-t5u6-7890-vwxy-z1234567890", "accountId": "x1y2z3a4-b5c6-7890-dfgh-i1234567890", "externalId": "e1f2g3h4", "type": "readiness", "score": 0.70, "state": "medium", "factors": [ { "name": "sleep_duration", "value": 412, "goal": 480, "unit": "minute", "score": 0.80, "state": "medium" }, { "name": "physical_recovery", "value": 62, "goal": 90, "unit": "minute", "score": 0.72, "state": "medium" }, { "name": "mental_recovery", "value": 93, "goal": 120, "unit": "minute", "score": 0.78, "state": "medium" }, { "name": "sleep_debt", "value": 2.75, "goal": 0, "unit": "hour", "score": 0.80, "state": "medium" }, { "name": "walking_strain_capacity", "value": 0.68, "goal": 1, "unit": "index", "score": 0.68, "state": "medium" }, { "name": "exercise_strain_capacity", "value": 0.57, "goal": 1, "unit": "index", "score": 0.57, "state": "low" }, { "name": "resting_heart_rate", "value": 60, "goal": 58, "unit": "bpm", "score": 0.95, "state": "high" }, { "name": "heart_rate_variability", "value": 50, "goal": 55, "unit": "ms", "score": 0.80, "state": "medium" } ], "dataSources": ["activity", "exercise", "sleep", "vitals"], "scoreDateTime": "2023-11-11T00:00:00+02:00", "createdAt": "2023-11-11T11:05:41.644Z", "version": 1.0}
For a breakdown of each field in the JSON response, please refer to the output schema on the health scores homepage.
Understanding the Readiness Score
Readiness measures the body's preparedness to tackle today's challenges based on recovery from physical strain. It is calculated using data from sleep, activity, exercise, and vital signs.
Important Note
For a detailed explanation of the how the readiness score works and recommendations to improve it, please refer to readiness score explained .
Interpreting the Score
The higher the Readiness Score, the more prepared an individual is for demanding physical and mental activities.
- 0.81 - 1.00 (High) : Well-recovered and ready for high-intensity activities.
- 0.61 - 0.80 (Medium) : Moderately recovered; suitable for moderate activities.
- 0.41 - 0.60 (Low) : Limited recovery; prioritize lighter activities.
- 0.00 - 0.40 (Minimal) : Minimal recovery; focus on rest and recuperation.
Factors in Readiness Score
The Readiness Score is calculated using several factors, each representing different aspects of recovery and strain:
Factor | Description | Data Sources | Requires Wearable |
---|---|---|---|
Sleep Duration | The total time spent sleeping, an integral part of recovery. | Sleep | No |
Physical Recovery (Deep Sleep) | The amount of deep sleep, crucial for muscle repair and physical restoration. | Sleep | Yes |
Mental Recovery (REM Sleep) | The amount of REM sleep, supporting cognitive functions and emotional regulation. | Sleep | Yes |
Sleep Debt | The accumulated shortfall between needed and actual sleep, affecting energy levels and recovery. | Sleep | No |
Walking Strain Capacity | An estimate of how well the body handles low-intensity activities based on recent patterns. | Activity, Exercise | No |
Exercise Strain Capacity | An evaluation of how well the body copes with higher-intensity activities, such as workouts. | Activity, Exercise | No |
Resting Heart Rate (RHR) | Lower RHR generally indicates better recovery. | Vitals | Yes |
Heart Rate Variability (HRV) | A higher HRV typically suggests better stress resilience. | Vitals | Yes |
Data Requirements
The Readiness Score calculation relies on several types of data. Below are the detailed requirements:
Full Data Types Needed:
- Sleep Data: Sleep duration, REM sleep stages, Deep sleep stages
- Activity Data: Step events, Exercise events
- Vitals Data: Resting Heart Rate (RHR), Heart Rate Variability (HRV)
Minimum Data Required:
A minimum of four contributing factors are required to compute a reliable Readiness Score. The minimum essential data includes:
- Sleep Data: Sleep duration
- Activity Data: Step events
Permissions Needed:
Platform | Permissions |
---|---|
Apple HealthKit (HK) | stepCount , HKWorkout , sleepAnalysis , restingHeartRate , heartRateVariabilitySDNN |
Google Health Connect (HC) | steps , ExerciseSession , SleepSession , RestingHeartRate , HeartRateVariabilityRmssd |
Handling Missing Data:
- If certain data points (e.g., no sleep data recorded for the day) are missing, the related factors will be returned as
null
. - The Readiness Score is designed to adjust for missing data when possible. However, if there aren’t enough factors to compute a reliable score (less than four factors available), the score itself will be returned as
null
.
Integrating the Readiness Score
To start receiving the Readiness Score setup webhooks (recommended) or use the API. You can also display the score in your application, using the UI widgets.
Webhooks
- In the dashboard navigate to Webhooks > 'Create new Webhook' > Health Scores > tick the 'Readiness score' box > paste in your destination URL.
- Once a readiness score is generated, the Webhook will automatically forward the event to your data store.
API
Retrieve readiness scores for a profile within a specific time window:
- Endpoint :
GET /api/v1/profile/score
- Authorization :
Bearer
token - Parameters :
-
types
: list of types (e.g.,readiness
) -
startDateTime
: Start date-time (ISO format) -
endDateTime
: End date-time (ISO format) -
version
: version of the score algorithm (default: 1)
-
- Responses :
- 200 : Returns readiness scores with details like id, type, state, score, factors, dataSources, scoreDateTime.
- 400 : Invalid profile ID.
- 401 : Invalid token.
- Example Request : curl -X GET "https://api.sahha.ai/v1/profile/score?types=readiness&startDateTime=2024-08-01T00:00:00Z&endDateTime=2024-08-31T23:59:59Z" \-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
For further details, refer to the API reference .
UI Widgets
You can also make use of UI Widgets to display the readiness score.
- Configure your app to utilise the widgets using the UI Widgets Guide
- Once configured simply paste the URL for the widget of your choice which can be any of: -
/arc
− which displays the score as an arc/factors
− which displays a list of the factors/chart
− displays the scores over time
Best Practices
Follow these best practices to ensure accurate interpretation and effective use of the Readiness Score:
- Data Variability : Results may vary based on the accuracy of data collected from different devices. For best results, the use of wearables is recommended.
- Personalized Baselines : The score adapts to each individual's unique lifestyle and habits, making it context-specific. Consider this personalization when presenting recommendations to users to ensure relevance and effectiveness.
- Interpretation : It's recommended to use the score in conjunction with how the user feels overall and other health indicators.
Frequently Asked Questions (FAQs)
Q: Can I use the Readiness Score without a wearable device?
A: Yes, the score can still be calculated using data from a smartphone, but it will be less detailed, some the factors will be missing. For more comprehensive measure, a wearable device is recommended. Learn more