Clarification on SpO2 Data for Non-Main Sleep Sessions

[diptopol]

According to the SpO2 API documentation, SpO2 data is specifically associated with a user's main sleep. However, we’ve observed that intraday SpO2 data is also being returned for sleep sessions where mainSleep=false.

Could you please clarify this behavior?

Should we expect SpO2 data to be available for all sleep sessions, or only for the main sleep?

[DorisFitbit]

Hi @diptopol

Thank you for reaching out. 

According to the official documentation for the "Get SpO2 Intraday by Date" endpoint (https://dev.fitbit.com/build/reference/web-api/intraday/get-spo2-intraday-by-date/), SpO2 data returned via this specific endpoint is designed to apply specifically to a user's "main sleep".

We understand you've observed SpO2 data being returned for non-main sleep periods. To help us understand this better and investigate further, could you please provide:

• A sample API request URL (with user-id and date redacted)
• A snippet of the JSON response showing the timestamps where SpO2 data appears for sleep sessions marked mainSleep=false.
• To provide complete context, could you also retrieve and share the Sleep Log data for the same date? This allows us to correlate the SpO2 readings with all recorded sleep sessions.

This information will help us determine if there is an issue or clarify the behavior you are observing. We look forward to your reply.