Download HRV through Web API

[checking_device]

Im trying to download HRV data through Web API, from my account for days which I had Sleep (more than 3 hrs) and HR data. I could download Sleep and HR data through Web API without a problem. But the HRV requests always returns empty data. 

What could be the reason why I'm not getting the HRV?

[Gordon-C]

Hi @checking_device 

In the documentation, we state several conditions that need to be met for HRV data to be collected.  Those are

• the Health Metrics tile in the user's mobile application dashboard is enabled.
• the data is only collected when the user is sleeping.
• the user must have a minimum of 3 hours of sleep.
• during the main sleep period, a sleep stages log is created.

I would first check the mobile application to see if HRV data was recorded.   If HRV data is not shown in the mobile application, then that would explain why data is not coming through the Web API.

Let us know what you find out.

[dave_996]

Hi @Gordon-C,

I'm facing the same issue, so thanks for the reply! Regarding the conditions for HRV data, the 2nd to 4th bullet points have been met, as the hours of sleep is more than 3 with the sleep stages log being present in the response from the Sleep Web API. As for the 1st bullet point, the Health Metrics dashboard is visible in the iOS Fitbit App (under settings > manage data and privacy > manage your data > HRV > review your data > trends). However, under each of the metrics headers (BR, HRV, Skin temp and SpO2), it states that "This feature is not available for your current device". May I know if this is what's causing the HRV Web API to return empty data, and if so, how can I resolve it?

Cheers,
Dave

[Gordon-C]

Hi @dave_996 

What device are you using?

[dave_996]

Hi @Gordon-C, the Fitbit device I used to record the sleep data was a Charge 5; if it helps I'm also using an iPhone 12 with iOS 16.1.1 for the Fitbit app

[Gordon-C]

Hi @dave_996 

Thank you for that information.   I'm not sure why the Charge 5 is not collecting your HRV data.  Since the data is not available in the mobile app, it would not be available through the Web API.   My recommendation would be to reach out to customer support at https://help.fitbit.com/support and have them troubleshoot your device.

[dave_996]

Hi @Gordon-C, will do, thanks for your help!

[dave_996]

Hi @Gordon-C,

Just to confirm, if no HRV data was present in the Fitbit app and Web API despite having sleep data from wearing the Fitbit device to sleep, does this mean that the HRV data cannot be recovered? Additionally, if all four conditions had already been met for obtaining HRV data, is it possible that HRV data could still be missing? 

Thanks,
Dave

[Gordon-C]

Hi @dave_996 

It's possible even with all 4 conditions being met, we were not able to generate HRV data.   However, just to make certain there isn't a problem with the device, I would contact customer support at https://help.fitbit.com/support to confirm HRV data was not generated.   They have better tools that might explain why.

[dave_996]

Thank you once again!