Integrating Apple Fitness+ Workouts – How to Retrieve Metadata?

Question

pbwhynot OP

Created Feb ’25

Replies 4

Boosts 0

Participants 3

Platform & Version:

iOS Version: 18.3.1 Development Environment: Xcode 16.2, macOS 14.6.1 Description of the Issue:

We're exploring ways to better integrate Apple Fitness+ workouts into our app. We've noticed that some third-party apps, such as Strava and HealthFit, now display Fitness+ workout details, including the title, trainer, and an image.

I’ve been investigating how this is possible, and the only relevant change I’ve found is that HKMetadataKeyAppleFitnessPlusCatalogIdentifier is now being set for Fitness+ workouts. However, I can’t find any public API or official documentation that explains how to use these identifiers to retrieve the associated workout details.

Question:

Is there an official API available to fetch metadata for Fitness+ workouts using these identifiers? Or are these third-party apps potentially accessing private APIs? If no API exists, is the only option to create a manual mapping of these identifiers—something that seems impractical given the constantly evolving Fitness+ workout catalog?

Any guidance on this would be greatly appreciated. Thanks!

Answered by DTS Engineer in 826969022

I can't comment third-party apps, but by looking into HkMetadata, I only see HKMetadataKeyAppleFitnessPlusSession, which is an NSNumber containing a BOOL value indicating whether or not a workout is from Apple Fitness+, and HKMetadataKeyAppleFitnessPlusCatalogIdentifier, which is a string containing the catalog identifier of the Fitness+ workout. I hence would suggest that you file a feedback report to request APIs for retrieving the information you need – If you do so, please share your report ID here for folks to track.

Best,
——
Ziqiao Chen
 Worldwide Developer Relations.

Boost

Answer 1

DTS Engineer OP

Apple

Feb ’25

Accepted Answer

I can't comment third-party apps, but by looking into HkMetadata, I only see HKMetadataKeyAppleFitnessPlusSession, which is an NSNumber containing a BOOL value indicating whether or not a workout is from Apple Fitness+, and HKMetadataKeyAppleFitnessPlusCatalogIdentifier, which is a string containing the catalog identifier of the Fitness+ workout. I hence would suggest that you file a feedback report to request APIs for retrieving the information you need – If you do so, please share your report ID here for folks to track.

Best,
——
Ziqiao Chen
 Worldwide Developer Relations.

2

Answer 2

DTS Engineer OP

Apple

Feb ’25

I will file a feedback report.

Thanks. Please share your report ID when you have it.

Just so we're clear, you are not currently aware of a way to get the Fitness+ workout image and name based on the HKMetadataKeyAppleFitnessPlusCatalogIdentifier?

That's right.

Best,
——
Ziqiao Chen
 Worldwide Developer Relations.

1

Answer 3

pbwhynot OP

Mar ’25

@DTS Engineer I got a reply to my feedback ticket. They told me to create a post on the Apple developer forums lol.

0

Answer 4

HydeParker OP

2w

I shared a similar concern on Reddit and got a reply suggesting there may be an unpublished API. Note that I went one better than filing. Feedback. My Apple Fitness+ data, is part of my Health Data. As such this is not a new feature request but a data access issue. I callled Apple Support they agreed , telling me I was not the first complaining about this. I was issued a case number. You can find my Reddit thread using my case number. Here’s my post:

I’ve been using Fitness+ for years and only just realized my HealthKit data is incomplete. Calories/duration sync fine, but instructor, episode number, and workout subtype (Upper/Lower/Total) are missing.

That info is clearly stored (it shows up in the Fitness+ Summary tab) but Apple withholds it from HealthKit and data exports. I called Apple Support and they confirmed I’m not the first person to ask. They gave me a case number: 102672392454.

👉 If this bugs you too, please file feedback here: apple.com/feedback or call support. The more users who push, the more likely Apple fixes this.

Anyone else trying to track long-term progress and hitting this same wall?

1