Medications - JSON Export Format
Documentation for medications structure in JSON exports
Last updated: October 31, 2026
Medication exports contain dose events for medications you allow Health Auto Export to read. They are stored in the JSON medications array and require iOS 26 or later. See medication access.
Structure
{
"displayText": "Example medication",
"nickname": "Daily medication",
"start": "2024-02-06 08:05:00 -0800",
"end": "2024-02-06 08:05:00 -0800",
"scheduledDate": "2024-02-06 08:00:00 -0800",
"status": "Taken",
"isArchived": false,
"dosage": 1,
"scheduledDosage": 1,
"units": "count",
"codings": []
}
Fields
displayText(String): Medication display name.nickname(String, optional): The medication’s nickname.start(String): Dose-event start time.end(String, optional): Dose-event end time, when available. These dates describe the event, not the start or end of a course of treatment.scheduledDate(String, optional): Scheduled time for the dose.status(String): Recorded dose status; see below.isArchived(Boolean): Whether the medication is archived in Apple Health.dosage(Number, optional): Recorded dose quantity.scheduledDosage(Number, optional): Scheduled dose quantity.units(String): Unit for dose quantities.codings(Array): Medication identifiers supplied by the recording source; may be empty.
Dates use yyyy-MM-dd HH:mm:ss Z. Unavailable optional fields are omitted rather than set to null.
Status values
English status values are Not Interacted, Notification Not Sent, Snoozed, Taken, Skipped, Not Logged, and Unspecified. These reflect the recorded event status.
Medication codings
Each coding contains code, system, and version strings. system identifies the coding system; version is an empty string when unavailable.