Help Center HealthyApps
English
Help Center
Main website ↗

Search help topics

Medications - JSON Export Format

Documentation for medications structure in JSON exports

Last updated: October 31, 2026

On this page
StructureFieldsStatus valuesMedication codingsRelated Documentation

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.