Mental Wellbeing Score

The Mental Wellbeing Score evaluates an individual's overall mental wellness by analyzing their behavioral patterns. The model identifies which aspects of the user's behavior may put them at risk or contribute to their resilience against mental health conditions. Based on clinically-used rating scales and extensive research, this score helps users understand their mental health state and assists in triaging for self-management, behavioral change, or seeking professional mental health advice.

{
  "id": "a1b2c3d4-e5f6-1234-efgh-ij1234567893",
  "profileId": "p1q2r3s4-t5u6-7890-vwxy-z1234567890",
  "accountId": "x1y2z3a4-b5c6-7890-dfgh-i1234567890",
  "externalId": "e1f2g3h4",
  "type": "mental_wellbeing",
  "score": 0.80,
  "state": "high",
  "factors": [
    { "name": "steps",                "value": 8000, "goal": 10000, "unit": "count",   "score": 0.80, "state": "high"   },
    { "name": "active_hours",         "value": 6,    "goal": 12,    "unit": "hour",    "score": 0.67, "state": "medium" },
    { "name": "extended_inactivity",  "value": 500,  "goal": 240,   "unit": "mintue",  "score": 0.80, "state": "high"   },
    { "name": "activity_regularity",  "value": 70,   "goal": 100,   "unit": "percent", "score": 0.70, "state": "medium" },
    { "name": "sleep_regularity",     "value": 85,   "goal": 100,   "unit": "percent", "score": 0.85, "state": "high"   },
    { "name": "circadian_alignment",  "value": 40,   "goal": 30,    "unit": "percent", "score": 0.90, "state": "high"   }
  ],
  "dataSources": ["age", "activity", "sleep"],
  "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 Mental Wellbeing Score

The Mental Wellbeing Score measures an individual's overall mental health based on their behavioral patterns. The model analyzes data such as physical activity and sleep to identify behaviors that may contribute to mental health risks or resilience.

Interpreting the Score

The higher the Mental Wellbeing Score, the better the mental state and resilience.

• 0.81 - 1.00 (High) : Indicates strong mental resilience and optimal behavioral patterns.
• 0.61 - 0.80 (Medium) : Suggests moderate mental resilience; potential areas for improvement.
• 0.41 - 0.60 (Low) : Reflects behaviors that may benefit from intervention to improve mental wellness.
• 0.00 - 0.40 (Minimal) : Denotes low mental resilience; significant changes may be required.

Factors in Mental Wellbeing Score

The Mental Wellbeing Score is calculated using several factors, each representing different aspects of behavior linked to mental health:

Data Requirements

The Mental Wellbeing Score calculation relies on activity, exercise, and sleep data. Below are the detailed requirements:

Full Data Types Needed:

• Activity Data: Steps.
• Exercise Data: Exercise sessions.
• Sleep Data: Bed and wake times.

Minimum Data Required:

A minimum of three contributing factors are required to compute a reliable Mental Wellbeing Score. The essential data includes:

• Activity Data: Steps.
• Sleep Data: Bed and wake times.

Permissions Needed:

Handling Missing Data:

• If certain data points are missing (e.g., no sleep data), the related factors will be returned as null.
• The Mental Wellbeing Score adjusts for missing data when possible. However, if there aren’t enough factors to compute a reliable score (less than three factors available), the score itself will be returned as null.

Integrating the Mental Wellbeing Score

To start receiving the Mental Wellbeing Score, set up webhooks (recommended) or use the API. You can also display the score in your application using the UI widgets.

Webhooks

1. In the dashboard , navigate to Webhooks > Create new Webhook > Health Scores > tick the Mental Wellbeing Score box > paste in your destination URL.
2. Once a Mental Wellbeing Score is generated, the webhook will automatically forward the event to your data store.

API

Retrieve Mental Wellbeing 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., mental_wellbeing)
  • startDateTime: Start date-time (ISO format)
  • endDateTime: End date-time (ISO format)
  • version: version of the score algorithm (default: 1)

• Responses :

  • 200 : Returns Mental Wellbeing 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=mental_wellbeing&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 Mental Wellbeing Score.

1. Configure your app to utilize the widgets using the UI Widgets Guide .

2. Once configured, simply paste the URL for the widget of your choice, which can be any of:

   /arc − displays the score as an arc.

   /factors − 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 Mental Wellbeing Score:

1. Data Accuracy : Encourage users to keep their activity and sleep tracking consistent for accurate assessment.
2. Privacy Considerations : Handle mental health data sensitively, ensuring compliance with privacy regulations.
3. Personalized Feedback : Use the factors to provide personalized recommendations to users for improving their mental wellbeing.
4. Holistic Approach : Encourage users to consider the Mental Wellbeing Score alongside other health indicators and personal feelings for a comprehensive view of their mental health.

Limitations and Considerations

The Mental Wellbeing Score is a wellness tool and not a diagnostic measure. It should not replace professional medical advice. Individual experiences and psychological factors can also influence mental health.

• Inference from Behavioral Data : The score infers mental wellbeing based on behavioral patterns captured through smartphones and wearables, providing a limited perspective.
• Not a Clinical Diagnosis : The score is indicative of mental wellness and resilience levels but is not a substitute for a clinical diagnosis.
• Score Factors : While the factors provide insights, they are derived from behavioral data and may not encompass all relevant variables affecting mental health, such as psychological factors.

Frequently Asked Questions (FAQs)

Q: Can I use the Mental Wellbeing Score without a wearable device?

A: Yes, the Mental Wellbeing Score can be calculated using data from a smartphone, such as steps and sleep patterns. However, more comprehensive data can enhance the accuracy of the score.

Q: How can I improve my Mental Wellbeing Score?

A: Improving your Mental Wellbeing Score involves maintaining consistent physical activity, achieving daily activity goals, ensuring regular sleep patterns, and minimizing periods of inactivity. Addressing significant deviations in your usual activity and sleep patterns can also help.

Q: What does a low Mental Wellbeing Score indicate?

A: A low Mental Wellbeing Score suggests behaviors that may benefit from intervention to improve mental health. It may be a prompt to evaluate lifestyle habits and consider seeking professional advice if needed.

Q: Is the Mental Wellbeing Score a diagnostic tool?

A: No, the Mental Wellbeing Score is an informational tool designed to provide insights into mental health based on behavioral patterns. It is not intended to diagnose any mental health conditions. For concerns about mental health, please consult a qualified professional.