Skip to content
More support
Contact us
  • There are no suggestions because the search field is empty.

Apple HealthKitV2 State of Mind Export Format

The HealthKit State of Mind export contains momentary emotion and daily mood check-in data recorded in Apple Health. Each entry captures a numeric valence score, a categorical valence classification, optional emotion labels, and optional contextual associations selected by the participant.

Data Structure

Four possible files will be created per export. The file names will correspond to the data type (e.g., "HealthKitV2StateOfMind_20250601-20250624", "HealthKitV2StateOfMind_Labels_20250601-20250624", "HealthKitV2StateOfMind_Associations_20250601-20250624", and "HealthKitV2StateOfMind_Deleted_20250601-20250624").

Your team will need to be mindful of the following entries, ensuring they are removed for analysis:

  • Duplicate Entries: You may see duplicate entries exported over time, typically occurring if a participant deletes and reinstalls MyDataHelps. HealthKit State of Mind entries are immutable, so when doing data analysis, your team will need to remove any entries that have the same HealthKitStateOfMindKey and ParticipantIdentifier as another entry.

  • Deleted Entries: Participants may delete their HealthKit State of Mind entries from their device. Deleted entries are tracked in a separate file.

State of Mind

Field Description
HealthKitStateOfMindKey A unique, auto-generated key for this State of Mind entry.
ParticipantIdentifier The identifier of the participant this entry was recorded for. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
StartDate The start date of the entry, in ISO 8601 format. Includes timezone offset information.
EndDate The end date of the entry, in ISO 8601 format. Includes timezone offset information.
Kind The type of State of Mind entry (e.g., "MomentaryEmotion", "DailyMood").
ValenceClassification A categorical label describing the overall emotional valence (e.g., "VeryUnpleasant", "Unpleasant", "SlightlyUnpleasant", "Neutral", "SlightlyPleasant", "Pleasant", "VeryPleasant").
Valence A numeric score representing emotional valence, ranging from -1 (most unpleasant) to 1 (most pleasant).
InsertedDate The creation date of the entry, in ISO 8601 format. Is always in UTC.

Labels

Field Description
HealthKitStateOfMindKey The key of the State of Mind entry this label belongs to. Can be used to cross reference with the State of Mind file.
ParticipantIdentifier The identifier of the participant this label was recorded for. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
Label An emotion or feeling label selected by the participant for this entry (e.g., "Amazed", "Hopeful", "Confident", "Satisfied").

Associations

Field Description
HealthKitStateOfMindKey The key of the State of Mind entry this association belongs to. Can be used to cross reference with the State of Mind file.
ParticipantIdentifier The identifier of the participant this association was recorded for. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
Association A contextual factor the participant associated with this entry (e.g., "Hobbies", "Work", "Tasks", "Weather").

Deleted State of Mind

Field Description
HealthKitStateOfMindKey A unique, auto-generated key for this State of Mind entry.
ParticipantIdentifier The identifier of the participant this entry was recorded for. Can be used to cross reference with Participants.
ParticipantID The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID).
DeletedDate The date the entry was deleted, in ISO 8601 format. Is always in UTC.

Sample CSV Exports

State of Mind

HealthKitStateOfMindKey,ParticipantIdentifier,StartDate,EndDate,Kind,ValenceClassification,Valence,InsertedDate,ParticipantID
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,2025-02-06T10:29:38-05:00,2025-02-06T10:29:38-05:00,MomentaryEmotion,SlightlyPleasant,0.21111104329427088,2025-06-06T15:39:05Z,539e5aec-e108-f011-b56a-147dda22d041
3583a609-3ceb-590d-95e0-0abc7feb1f72,MDH-3229-1050,2024-12-10T10:30:37-05:00,2024-12-10T10:30:37-05:00,DailyMood,Pleasant,0.6399999999999999,2025-06-06T15:39:05Z,539e5aec-e108-f011-b56a-147dda22d041

Labels

HealthKitStateOfMindKey,ParticipantIdentifier,ParticipantID,Label
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Amazed
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Hopeful
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Confident
3583a609-3ceb-590d-95e0-0abc7feb1f72,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Satisfied

Associations

HealthKitStateOfMindKey,ParticipantIdentifier,ParticipantID,Association
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Hobbies
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Work
3583a609-3ceb-590d-95e0-0abc7feb1f72,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Tasks
3583a609-3ceb-590d-95e0-0abc7feb1f72,MDH-3229-1050,539e5aec-e108-f011-b56a-147dda22d041,Weather

Deleted State of Mind

HealthKitStateOfMindKey,ParticipantIdentifier,DeletedDate,ParticipantID
5f2fd329-63a2-5604-be91-5eb598ed41af,MDH-3229-1050,2025-06-06T15:43:20Z,539e5aec-e108-f011-b56a-147dda22d041

Sample JSON Exports

State of Mind

{
 "HealthKitStateOfMindKey":"5f2fd329-63a2-5604-be91-5eb598ed41af",
 "ParticipantIdentifier":"MDH-3229-1050",
 "ParticipantID":"539e5aec-e108-f011-b56a-147dda22d041",
 "StartDate":"2025-02-06T10:29:38-05:00",
 "EndDate":"2025-02-06T10:29:38-05:00",
 "InsertedDate":"2025-06-06T15:39:05Z",
 "Kind":"MomentaryEmotion",
 "Valence":0.21111104329427088,
 "ValenceClassification":"SlightlyPleasant",
 "Labels":[
   "Amazed",
   "Hopeful",
   "Confident"
 ],
 "Associations":[
   "Hobbies",
   "Work"
 ]
}
{
 "HealthKitStateOfMindKey":"3583a609-3ceb-590d-95e0-0abc7feb1f72",
 "ParticipantIdentifier":"MDH-3229-1050",
 "ParticipantID":"539e5aec-e108-f011-b56a-147dda22d041",
 "StartDate":"2024-12-10T10:30:37-05:00",
 "EndDate":"2024-12-10T10:30:37-05:00",
 "InsertedDate":"2025-06-06T15:39:05Z",
 "Kind":"DailyMood",
 "Valence":0.6399999999999999,
 "ValenceClassification":"Pleasant",
 "Labels":[
   "Satisfied"
 ],
 "Associations":[
   "Tasks",
   "Weather"
 ]
}

Deleted State of Mind

{
 "HealthKitStateOfMindKey":"5f2fd329-63a2-5604-be91-5eb598ed41af",
 "ParticipantIdentifier":"MDH-3229-1050",
 "ParticipantID":"539e5aec-e108-f011-b56a-147dda22d041",
 "DeletedDate":"2025-06-06T15:43:20Z"
}