v1

latestOpenAPI 3.1.02026-07-136587849.3 KB

Queries / Statistics

Daily Statistics

This endpoint returns daily statistics calculated based on the data available for a specific time period. The data is aggregated for each day based on the user's local timezone.

<Note> Refer to the different statistics types in the [Statistics Types](/technical-references/statistics_matrix) section for more information on how the data is aggregated for each type. </Note>

User's Local Timezone

The /statistics/daily endpoint uses the user's local timezone for all its calculations. This approach ensures that the data reflects the user's actual daily activity patterns, providing a more personalized view. By using the local timezone, the API tailors the data to the user's specific context, which is particularly useful for applications that focus on individual user experiences. This approach contrasts with the /statistics/interval endpoint, which uses Coordinated Universal Time (UTC) for calculations, offering a standardized global view.

get/queries/statistics/daily

Query parameters

from_datestring date required

Start time of the query range in user's local timezone according to the provider, inclusive

Example:2006-01-02

Start time of the query range in user's local timezone according to the provider, inclusive

to_datestring date required

End time of the query range in user's local timezone according to the provider, inclusive

Example:2006-01-02

End time of the query range in user's local timezone according to the provider, inclusive

exclude_manualboolean

Exclude manual metrics from the statistics

typesstring[] required

providersstring[]

[
  "strava"
]

include_record_idsboolean

Whether to include the record IDs in the response

device_typesstring[]

Device types to include in the statistics

Response

from_datestring date required

Calendar date in user's local timezone according to the provider

to_datestring date required

Calendar date in user's local timezone according to the provider

Example response

{
  "from_date": "2006-01-02",
  "statistics": [
    {
      "date": "2006-01-02",
      "record_ids": [
        "12345678-1234-abcd-4321-abcdef123456"
      ],
      "values": {
        "activity_score": 83,
        "calories_burned_active": 1020.0991,
        "calories_burned_basal": 2000.1242,
        "calories_burned_total": 3020.2233,
        "distance_cycling": 20091.0022,
        "distance_running": 12000.1014,
        "distance_total": 5880.7021,
        "distance_walking": 1200.7022,
        "duration_high_intensity": 1200000,
        "duration_low_intensity": 9000000,
        "duration_moderate_intensity": 2400000,
        "heartrate": 100,
        "heartrate_max": 120,
        "heartrate_min": 60,
        "heartrate_resting": 60,
        "hrv_rmssd": 45,
        "hrv_sdnn": 52,
        "recovery_score": 83,
        "sleep_duration_total": 3600000,
        "sleep_score": 70,
        "sleep_skin_temperature_deviation": -0.13,
        "steps": 10000,
        "stress_score": 70
      }
    }
  ],
  "to_date": "2006-01-02"
}