Apple Health data dictionary — every HealthKit identifier, mapped
Every measurement type Apple Health can export, and what each one becomes when it is read. The mapping below is generated from the parser’s own identifier table, so it is exactly what the tool does with your file — not a hand-kept list that drifts from it.
How to read this table
Apple names each measurement with a long HK…TypeIdentifier… string. The parser
maps every one to a canonical kind and a canonical unit,
so heart rate from a Watch and heart rate from a chest strap end up the same shape. There
are 58 identifiers in the table; 13 of
them have a page of their own explaining a specific trap, linked from the first column.
Three families exist. Quantity types are single numbers (heart rate, a step count). Category types are tokens rather than numbers — sleep is the one that matters. Correlation types bind two values together — blood pressure is systolic and diastolic — and are the ones simple importers drop.
Correlation types
| Identifier | Canonical kind | Usual unit |
|---|---|---|
| HKCorrelationTypeIdentifierBloodPressure | BloodPressure | mmHg |
Category types
| Identifier | Canonical kind | Usual unit |
|---|---|---|
| HKCategoryTypeIdentifierSleepAnalysis | SleepStage | token |
Quantity types
| Identifier | Canonical kind | Usual unit |
|---|---|---|
| HKQuantityTypeIdentifierAppleSleepingWristTemperature | SkinTemperatureDelta | degC |
| HKQuantityTypeIdentifierBloodGlucose | BloodGlucose | mg/dL |
| HKQuantityTypeIdentifierBodyMass | BodyMass | kg |
| HKQuantityTypeIdentifierDistanceSwimming | Distance | m |
| HKQuantityTypeIdentifierHeartRate | HeartRate | count/min |
| HKQuantityTypeIdentifierHeartRateVariabilitySDNN | Hrv | ms |
| HKQuantityTypeIdentifierOxygenSaturation | Spo2 | % |
| HKQuantityTypeIdentifierRespiratoryRate | RespiratoryRate | count/min |
| HKQuantityTypeIdentifierRestingHeartRate | HeartRateResting | count/min |
| HKQuantityTypeIdentifierRunningPower | RunningPower | W |
| HKQuantityTypeIdentifierStepCount | Steps | count |
HKQuantityTypeIdentifierActiveEnergyBurned | ActiveEnergy | kcal |
HKQuantityTypeIdentifierAppleExerciseTime | ActiveMinutes | min |
HKQuantityTypeIdentifierBasalEnergyBurned | BasalEnergy | kcal |
HKQuantityTypeIdentifierBodyFatPercentage | BodyFatPercent | fraction |
HKQuantityTypeIdentifierBodyTemperature | BodyTemperature | degC |
HKQuantityTypeIdentifierDietaryCalcium | DietaryCalcium | mg |
HKQuantityTypeIdentifierDietaryCarbohydrates | DietaryCarbohydrates | g |
HKQuantityTypeIdentifierDietaryCholesterol | DietaryCholesterol | mg |
HKQuantityTypeIdentifierDietaryCopper | DietaryCopper | mg |
HKQuantityTypeIdentifierDietaryEnergyConsumed | DietaryEnergy | kcal |
HKQuantityTypeIdentifierDietaryFatMonounsaturated | DietaryFatMonounsaturated | g |
HKQuantityTypeIdentifierDietaryFatPolyunsaturated | DietaryFatPolyunsaturated | g |
HKQuantityTypeIdentifierDietaryFatSaturated | DietaryFatSaturated | g |
HKQuantityTypeIdentifierDietaryFatTotal | DietaryFatTotal | g |
HKQuantityTypeIdentifierDietaryFiber | DietaryFiber | g |
HKQuantityTypeIdentifierDietaryFolate | DietaryFolate | mcg |
HKQuantityTypeIdentifierDietaryIron | DietaryIron | mg |
HKQuantityTypeIdentifierDietaryMagnesium | DietaryMagnesium | mg |
HKQuantityTypeIdentifierDietaryManganese | DietaryManganese | mg |
HKQuantityTypeIdentifierDietaryNiacin | DietaryNiacin | mg |
HKQuantityTypeIdentifierDietaryPhosphorus | DietaryPhosphorus | mg |
HKQuantityTypeIdentifierDietaryPotassium | DietaryPotassium | mg |
HKQuantityTypeIdentifierDietaryProtein | DietaryProtein | g |
HKQuantityTypeIdentifierDietaryRiboflavin | DietaryRiboflavin | mg |
HKQuantityTypeIdentifierDietarySelenium | DietarySelenium | mcg |
HKQuantityTypeIdentifierDietarySodium | DietarySodium | mg |
HKQuantityTypeIdentifierDietarySugar | DietarySugar | g |
HKQuantityTypeIdentifierDietaryThiamin | DietaryThiamin | mg |
HKQuantityTypeIdentifierDietaryVitaminA | DietaryVitaminA | mcg |
HKQuantityTypeIdentifierDietaryVitaminB12 | DietaryVitaminB12 | mcg |
HKQuantityTypeIdentifierDietaryVitaminB6 | DietaryVitaminB6 | mg |
HKQuantityTypeIdentifierDietaryVitaminC | DietaryVitaminC | mg |
HKQuantityTypeIdentifierDietaryVitaminE | DietaryVitaminE | mg |
HKQuantityTypeIdentifierDietaryVitaminK | DietaryVitaminK | mcg |
HKQuantityTypeIdentifierDietaryWater | DietaryWater | mL |
HKQuantityTypeIdentifierDietaryZinc | DietaryZinc | mg |
HKQuantityTypeIdentifierDistanceCycling | Distance | km |
HKQuantityTypeIdentifierDistanceWalkingRunning | Distance | km |
HKQuantityTypeIdentifierFlightsClimbed | FlightsClimbed | count |
HKQuantityTypeIdentifierHeight | Height | cm |
HKQuantityTypeIdentifierLeanBodyMass | LeanBodyMass | kg |
HKQuantityTypeIdentifierRunningGroundContactTime | GroundContactTime | ms |
HKQuantityTypeIdentifierRunningStrideLength | StrideLength | m |
HKQuantityTypeIdentifierRunningVerticalOscillation | VerticalOscillation | cm |
HKQuantityTypeIdentifierVO2Max | Vo2Max | mL/min·kg |
Reading your own export
To see which of these your file actually contains, and how many of each, drop your export.zip on the reader — it runs on your device and uploads nothing. The identifier pages linked above each read a single measure and explain what makes it easy to get wrong.