Help Center HealthyApps
English
Help Center
Main website ↗

Search help topics

State of Mind - JSON Export Format

Documentation for state of mind structure in JSON exports

Last updated: October 31, 2026

On this page
Structure
Fields Fields Entry Fields
Related Documentation

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.