Skip to main content

​
May 2025

​
New daily statistics endpoint

Daily statistics are calculated based on the data available for a specific day range. The data is aggregated for each day based on the user’s local timezone. The aggregation process involves summing up, averaging, or finding minimum and maximum values for the data points within each day, depending on the type of statistic being queried. This allows you to see trends and patterns over time, making it easier to analyze the data and draw meaningful insights. See the endpoint specification in Daily Statistics.

​
Time range parameters in requests

New pairs of time range parameters from_timestamp, to_timestamp and from_date, to_date supersede the deprecated ones from, to and timezone.
  • from_timestamp and to_timestamp must be used in all endpoints that expect time range with timestamps. They must be in the UTC timezone, therefore timezone is no longer used. The formats allowed are 2006-01-02T15:04:05 and 2006-01-02T15:04:05Z.
  • from_date and to_date must be used for endpoints that provide daily summaries (Daily Statistics) and sleep data (List Sleeps). The format allowed is 2006-01-02.

​
July 2025

​
Breathing rate metrics consolidated

Respiratory metrics breathing_rate, breathing_rate_min, and breathing_rate_max will be used in sleep endpoints instead of the deprecated sleep_breathing_rate, sleep_breathing_rate_min, and sleep_breathing_rate_max. This change standardizes metric naming by removing the sleep_ prefix, improving consistency across respiratory metrics. The underlying data and calculations remain unchanged — only the metric names have been updated. Please update your integration code accordingly.