State of Mind

State of Mind data captures your mood and mental state entries recorded in Apple Health. This feature is available on iOS 18.0 and later. In JSON exports, State of Mind entries are stored in the stateOfMind array.

Structure

Each State of Mind entry includes information about your mood, emotional valence, labels, and associations:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "start": "2024-02-06T22:00:00Z",
  "end": "2024-02-06T22:05:00Z",
  "kind": "daily_mood",
  "labels": ["calm", "confident"],
  "associations": ["work", "tasks"],
  "valence": 0.7,
  "valenceClassification": "very_pleasant",
  "metadata": {
    "customKey": "customValue"
  }
}

Fields

Entry Fields

• id (String): Unique identifier for the State of Mind entry
• start (String): Start time as an ISO 8601 timestamp, such as 2024-02-06T22:00:00Z
• end (String): End time as an ISO 8601 timestamp, such as 2024-02-06T22:05:00Z
• kind (String): Type of entry: daily_mood or momentary_emotion
• labels (Array): Labels describing your state, using lowercase values such as calm, anxious, happy, or stressed
• associations (Array): Contexts associated with your state, using lowercase or snake-case values such as work, fitness, family, current_events, or self_care
• valence (Number): Emotional valence ranging from -1.0 (very unpleasant) to 1.0 (very pleasant)
• valenceClassification (String): Classification of the valence: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant, or very_pleasant
• metadata (Object<String, String>, optional): String metadata attached to the entry. The field is omitted when no metadata is available.

Understanding Valence

Valence represents the emotional quality of your state of mind:

• Negative valence (values closer to -1.0): Unpleasant or negative emotional states
• Neutral valence (values around 0.0): Neutral emotional states
• Positive valence (values closer to 1.0): Pleasant or positive emotional states

The valenceClassification string provides a category, while valence offers a more precise numerical value.

Labels and Associations

• Labels describe how you're feeling (for example, calm, anxious, happy, or stressed)
• Associations provide context about what you were doing or what influenced your state (for example, work, fitness, friends, or family)

Example Entry

{
  "id": "9f4a09ba-3933-4f2a-b165-5c5c76513e99",
  "start": "2024-02-06T08:00:00Z",
  "end": "2024-02-06T08:05:00Z",
  "kind": "momentary_emotion",
  "labels": ["excited", "hopeful"],
  "associations": ["fitness", "self_care"],
  "valence": 0.8,
  "valenceClassification": "very_pleasant",
  "metadata": {}
}

This entry indicates:

• A very pleasant momentary emotion with a valence of 0.8
• Feeling excited and hopeful
• Associated with fitness and self-care
• Recorded at 08:00 UTC

Availability

State of Mind export is available on iOS 18.0 and later. If you're using an older iOS version, this data type will not be available in your exports.

Use Cases

State of Mind data can be useful for:

• Mood tracking: Analyzing patterns in your emotional well-being over time
• Correlation analysis: Understanding relationships between activities and mood
• Mental health monitoring: Tracking changes in emotional state
• Wellness insights: Identifying factors that contribute to positive or negative states

Related Documentation

• JSON Export Format Overview
• Manual Export Guide
• Automations Overview