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-06 14:00:00 -0800",
  "end": "2024-02-06 14:05:00 -0800",
  "kind": "mood",
  "labels": ["Calm", "Focused"],
  "associations": ["Work", "Productive"],
  "valence": 0.7,
  "valenceClassification": 1,
  "metadata": {
    "customKey": "customValue"
  }
}

Fields

Required Fields

• id (String): Unique identifier for the State of Mind entry
• start (String): Start time of the entry in format yyyy-MM-dd HH:mm:ss Z
• end (String): End time of the entry in format yyyy-MM-dd HH:mm:ss Z
• kind (String): Type of State of Mind entry (typically "mood")
• labels (Array): Array of labels describing your state (e.g., "Calm", "Anxious", "Happy", "Stressed")
• associations (Array): Array of associations or contexts (e.g., "Work", "Exercise", "Family")
• valence (Number): Emotional valence rating, typically ranging from -1.0 (very negative) to 1.0 (very positive)
• valenceClassification (Number): Classification of valence:
  • -1: Very negative
  • 0: Neutral
  • 1: Very positive
• metadata (ObjectString:String): Additional metadata as key-value pairs

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 provides a simplified categorization, while valence offers a more precise numerical value.

Labels and Associations

• Labels describe how you're feeling (e.g., "Calm", "Anxious", "Energetic", "Tired")
• Associations provide context about what you were doing or what influenced your state (e.g., "Work", "Exercise", "Social", "Sleep")

Example Entry

{
  "id": "abc123-def456-ghi789",
  "start": "2024-02-06 08:00:00 -0800",
  "end": "2024-02-06 08:05:00 -0800",
  "kind": "mood",
  "labels": ["Energetic", "Motivated"],
  "associations": ["Morning Routine", "Exercise"],
  "valence": 0.8,
  "valenceClassification": 1,
  "metadata": {}
}

This entry indicates:

• A positive mood state (valence 0.8, classification 1)
• Feeling energetic and motivated
• Associated with morning routine and exercise
• Recorded at 8:00 AM

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