v1

latestOpenAPI 3.1.02026-07-136587849.3 KB

Queries / Provider Records

List Provider Records

This endpoint allows you to query provider records with metrics, optionally filtering by providers. It supports filtering by UTC timestamp range and providers, and includes provider-specific metrics in the response.

The response includes records with raw data from providers transformed into the unified data model, each possibly including:

base information (start, end, duration, user time offset, input method, source provider, etc.)
metrics (base and provider-specific)
activity information such as activity ID, type, and tags
activity breakdown into laps, sessions, etc.
sleeps with sample data

All timestamps in both request and response are in the UTC timezone.

get/queries/provider_records

Query parameters

from_timestampstring date-time

Start time of the query range in UTC, inclusive

Example:2006-01-02T15:04:05

Start time of the query range in UTC, inclusive

to_timestampstring date-time

End time of the query range in UTC, non-inclusive

Example:2006-01-02T15:04:05

End time of the query range in UTC, non-inclusive

providersstring[]

metricsstring[]

Include metrics

include_provider_specific_metricsboolean

Include provider specific metrics such as unique sleep score

Response

from_timestampstring date-time

to_timestampstring date-time

Example response

{
  "from_timestamp": "2006-01-02T00:00:00Z",
  "records": [
    {
      "metrics": {
        "air_temperature": 22.73,
        "air_temperature_max": 28.55,
        "air_temperature_min": 15.27,
        "ascent": 320.29,
        "basal_body_temperature": 36.53,
        "basal_body_temperature_max": 37.03,
        "basal_body_temperature_min": 36.01,
        "bedtime_duration": 28800000,
        "blood_pressure_diastolic": 80.03,
        "blood_pressure_diastolic_max": 90.07,
        "blood_pressure_diastolic_min": 60.01,
        "blood_pressure_systolic": 120.03,
        "blood_pressure_systolic_max": 140.07,
        "blood_pressure_systolic_min": 100.01,
        "body_bone_mass": 3200,
        "body_fat": 18.53,
        "body_fat_max": 25.03,
        "body_fat_min": 12.01,
        "body_mass_index": 22.5016,
        "body_temperature": 36.73,
        "body_temperature_max": 37.55,
        "body_temperature_min": 36.13,
        "breathing_rate": 16.5016,
        "breathing_rate_max": 24.7549,
        "breathing_rate_min": 12.2534,
        "cadence": 85.5016,
        "cadence_max": 110.0049,
        "cadence_min": 60.0034,
        "calories_burned": 1650.7549,
        "calories_burned_active": 450.2516,
        "calories_burned_basal": 1200.5034,
        "calories_intake": 2100.5016,
        "descent": 280.91,
        "distance": 6500.2516,
        "distance_cycling": 15000.7549,
        "distance_running": 5000.5016,
        "distance_swimming": 1000.7549,
        "distance_walking": 3200.5034,
        "distance_wheelchair": 2800.5034,
        "duration_active": 5400000,
        "duration_high_intensity": 1200000,
        "duration_low_intensity": 9000000,
        "duration_moderate_intensity": 2400000,
        "ecg_rri": 850,
        "ecg_voltage": 1200.53,
        "elevation": 1050.73,
        "elevation_gain": 450.83,
        "elevation_loss": 380.47,
        "elevation_max": 1250.55,
        "elevation_min": 850.37,
        "floors_climbed": 12,
        "glucose": 95.654321,
        "heartrate": 90,
        "heartrate_max": 180,
        "heartrate_min": 60,
        "heartrate_resting": 70,
        "heartrate_resting_max": 85,
        "heartrate_resting_min": 60,
        "heartrate_zone0_duration": 5000,
        "heartrate_zone1_duration": 7152,
        "heartrate_zone2_duration": 25000,
        "heartrate_zone3_duration": 18170,
        "heartrate_zone4_duration": 6372,
        "heartrate_zone5_duration": 2000,
        "height": 1.7549,
        "hrv_rmssd": 45,
        "hrv_sdnn": 52,
        "latitude": 37.77492948,
        "longitude": -122.41941637,
        "pace": 3.53,
        "power": 125,
        "power_max": 125,
        "skin_temperature": 33.53,
        "skin_temperature_max": 34.27,
        "skin_temperature_min": 32.89,
        "sleep_breathing_rate": 14.27,
        "sleep_breathing_rate_max": 18.59,
        "sleep_breathing_rate_min": 10.03,
        "sleep_duration": 25200000,
        "sleep_duration_awake": 1800000,
        "sleep_duration_deep": 5400000,
        "sleep_duration_light": 12600000,
        "sleep_duration_nap": 3600000,
        "sleep_duration_rem": 3600000,
        "sleep_efficiency": 92,
        "sleep_interruptions": 2,
        "sleep_latency": 900000,
        "sleep_score": 85,
        "sleep_skin_temperature_deviation": -0.13,
        "speed": 3.2516,
        "speed_max": 8.5034,
        "speed_min": 0.5016,
        "spo2": 98.5016,
        "spo2_max": 99.5034,
        "spo2_min": 95.2516,
        "steps": 8500,
        "swimming_distance_per_stroke": 2.27,
        "swimming_lengths": 40,
        "vo2max": 45.23,
        "wakeup_latency": 600000,
        "weight": 70000.5034
      },
      "provider_local_date": "2006-01-02",
      "provider_slug": "strava",
      "record_id": "12345678-1234-abcd-4321-abcdef123456"
    }
  ],
  "to_timestamp": "2006-01-02T00:00:00Z"
}