State of Mind - JSON Export Format
Documentation for state of mind structure in JSON exports
Last updated: October 31, 2026
On this page
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 entrystart(String): Start time as an ISO 8601 timestamp, such as2024-02-06T22:00:00Zend(String): End time as an ISO 8601 timestamp, such as2024-02-06T22:05:00Zkind(String): Type of entry:daily_moodormomentary_emotionlabels(Array): Labels describing your state, using lowercase values such as calm,anxious,happy, orstressedassociations(Array): Contexts associated with your state, using lowercase or snake-case values such as work,fitness,family,current_events, orself_carevalence(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, orvery_pleasantmetadata(Object<String, String>, optional): String metadata attached to the entry. The field is omitted when no metadata is available.