Heart Metrics

You can retrieve user resting heart rate (HR) data by user_id and filter by date range
﻿
Get a heart data by user_id
GET
Params
Query Parameters
user_id
required
String
User ID returned by add integration request. This key should be stored in your database against the user and used for all interactions with the Spike API.
start_date
required
String
Date from in YYYY-MM-DD format
end_date
required
String
Date to in YYYY-MM-DD format
Header Parameters
authorizationtoken
required
String
Client access token (deprecated)
x-spike-auth
required
String
Client access token
Python
|
import requests

url = "https://api.spikeapi.com/metrics/heart/?user_id=282812818&start_date=2020-05-01&end_date=2020-05-03"
headers = {}
headers['x-spike-auth'] = 'fa0b3803-1111-2222-9788-eccce210d30c'
response = requests.request("GET", url, headers=headers)

print(response.text)
import requests

url = "https://api.spikeapi.com/metrics/heart/?user_id=282812818&start_date=2020-05-01&end_date=2020-05-03"
headers = {}
headers['x-spike-auth'] = 'fa0b3803-1111-2222-9788-eccce210d30c'
response = requests.request("GET", url, headers=headers)

print(response.text)
RESPONSES
200
|
{
    "user_key": "282812818",
    "start_date": "2020-05-01",
    "end_date": "2020-05-03",
    "type": "heart",
    "sources": [
        {
            "name": "fitbit",
            "status": "ok"
        }
    ],
    "data": [
        {
            "date": "2020-05-01",
            "timezone_offset": 7200,
            "resting_hr": 56,
            "min_hr": 48,
            "avg_hr": 66,
            "max_hr": 117,
            "heart_rate_samples": [
                {
                    "time": "2022-05-01T00:00:15",
                    "value": 56
                },
                {  
                    "time": "2022-05-01T00:00:30",
                    "value": 56
                },
            ],
            "heart_rate_variability": {
               "day_hrv": 77.1,
               "sleep_hrv": 89
            },
            "intraday_hrv": [
                {
                    "value": {
                        "rmssd": 28.492,
                        "coverage": 0.945,
                        "hf": 97.61,
                        "lf": 121.196
                    },
                    "time": "2022-05-01T00:00:15",
                }
            ],
            "source": "garmin"
        }
    ]
} 
{
    "user_key": "282812818",
    "start_date": "2020-05-01",
    "end_date": "2020-05-03",
    "type": "heart",
    "sources": [
        {
            "name": "fitbit",
            "status": "ok"
        }
    ],
    "data": [
        {
            "date": "2020-05-01",
            "timezone_offset": 7200,
            "resting_hr": 56,
            "min_hr": 48,
            "avg_hr": 66,
            "max_hr": 117,
            "heart_rate_samples": [
                {
                    "time": "2022-05-01T00:00:15",
                    "value": 56
                },
                {  
                    "time": "2022-05-01T00:00:30",
                    "value": 56
                },
            ],
            "heart_rate_variability": {
               "day_hrv": 77.1,
               "sleep_hrv": 89
            },
            "intraday_hrv": [
                {
                    "value": {
                        "rmssd": 28.492,
                        "coverage": 0.945,
                        "hf": 97.61,
                        "lf": 121.196
                    },
                    "time": "2022-05-01T00:00:15",
                }
            ],
            "source": "garmin"
        }
    ]
} 
﻿
<style>
@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300&display=swap');

.h2, .h3, .list, .description{
	font-family: 'Poppins', sans-serif;
	font-weight: 500;
}

.h2 {
    margin-top: -20px;
    margin-bottom: 20px;

    font-size: 30px;
}

.h3 {
    font-size: 22px;
	margin-top: -20px;
}

.list-wrapper {
    white-space: normal;
     margin-top: -10px;
}

.list, .description {
    font-size: 14px;
}

</style>
<h2 class="h2">Fields</h2>
<h3 class="h3">Heart.date</h3>
<ul class="list-wrapper">
    <li class="list">Type: String</li>
    <li class="list">Format: Date, YYYY-MM-DD</li>
    <li class="list">Example: 2020-05-01</li>
</ul><p class="description">Date of measurement. For Whoop, date when the cycle ende</p>

<h3 class="h3">Heart.resting_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 56</li>
</ul><p class="description">Average resting heart rate</p>

<h3 class="h3">Heart.min_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 56</li>
</ul><p class="description">Minimum of heart rate values captured during the monitoring period, in beats per minute.</p>

<h3 class="h3">Heart.avg_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 56</li>
</ul><p class="description">Average of heart rate values captured during the monitoring period, in beats per minute.</p>

<h3 class="h3">Heart.max_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 156</li>
</ul><p class="description">Maximum of heart rate values captured during the monitoring period, in beats per minute.</p>

<h3 class="h3">Heart.heart_rate_samples.time</h3>
<ul class="list-wrapper">
    <li class="list">Type: string</li>
    <li class="list">Format: Date time, YYYY-MM-DDThh:mm:ss</li>
    <li class="list">Example: 2022-02-19T00:00:15</li>
</ul><p class="description">The time of the measurement</p>

<h3 class="h3">Heart.heart_rate_samples.value</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 156</li>
</ul><p class="description">Heart rate value recorded for that time, in beats per minute. Each entry is a representative sample of the previous 15 seconds from the given time</p>

<h3 class="h3">Heart.heart_rate_variability.day_hrv</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Unit: Milliseconds (ms)</li>
    <li class="list">Example: 39.657</li>
</ul><p class="description">The Root Mean Square of Successive Differences (RMSSD) between heart beats. It measures short-term variability in the user’s daily heart rate in milliseconds (ms).</p>

<h3 class="h3">Heart.heart_rate_variability.sleep_hrv</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Unit: Milliseconds (ms)</li>
    <li class="list">Example: 42.157</li>
</ul><p class="description">The Root Mean Square of Successive Differences (RMSSD) between heart beats. It measures short-term variability in the user’s heart rate while in deep sleep, in milliseconds (ms).</p>

<h3 class="h3">Heart.intraday_hrv.value.rmssd</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Unit: Milliseconds (ms)</li>
    <li class="list">Example: 28.492</li>
</ul><p class="description">The Root Mean Square of Successive Differences (RMSSD) between heart beats. It measures short-term variability in the user’s heart rate in milliseconds (ms).</p>

<h3 class="h3">Heart.intraday_hrv.value.coverage</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Example: 0.945</li>
</ul><p class="description">Data completeness in terms of the number of interbeat intervals.</p>

<h3 class="h3">Heart.intraday_hrv.value.hf</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Example: 97.61</li>
</ul><p class="description">The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz).</p>

<h3 class="h3">Heart.intraday_hrv.value.lf</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Example: 121.196</li>
</ul><p class="description">The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz).</p>

<h3 class="h3">Heart.intraday_hrv.time</h3>
<ul class="list-wrapper">
    <li class="list">Type: string</li>
    <li class="list">Format: Date time, YYYY-MM-DDThh:mm:ss</li>
    <li class="list">Example: 2022-02-19T00:00:15</li>
</ul><p class="description">The time of the measurement</p>

<h3 class="h3">Heart.source</h3>
<ul class="list-wrapper">
    <li class="list">Type: String</li>
    <li class="list">Example: fitbit</li>
</ul><p class="description">Data source</p>

<style>
@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300&display=swap');

.h2, .h3, .list, .description{
	font-family: 'Poppins', sans-serif;
	font-weight: 500;
}

.h2 {
    margin-top: -20px;
    margin-bottom: 20px;

    font-size: 30px;
}

.h3 {
    font-size: 22px;
	margin-top: -20px;
}

.list-wrapper {
    white-space: normal;
     margin-top: -10px;
}

.list, .description {
    font-size: 14px;
}

</style>
<h2 class="h2">Fields</h2>
<h3 class="h3">Heart.date</h3>
<ul class="list-wrapper">
    <li class="list">Type: String</li>
    <li class="list">Format: Date, YYYY-MM-DD</li>
    <li class="list">Example: 2020-05-01</li>
</ul><p class="description">Date of measurement. For Whoop, date when the cycle ende</p>

<h3 class="h3">Heart.resting_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 56</li>
</ul><p class="description">Average resting heart rate</p>

<h3 class="h3">Heart.min_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 56</li>
</ul><p class="description">Minimum of heart rate values captured during the monitoring period, in beats per minute.</p>

<h3 class="h3">Heart.avg_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 56</li>
</ul><p class="description">Average of heart rate values captured during the monitoring period, in beats per minute.</p>

<h3 class="h3">Heart.max_hr</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 156</li>
</ul><p class="description">Maximum of heart rate values captured during the monitoring period, in beats per minute.</p>

<h3 class="h3">Heart.heart_rate_samples.time</h3>
<ul class="list-wrapper">
    <li class="list">Type: string</li>
    <li class="list">Format: Date time, YYYY-MM-DDThh:mm:ss</li>
    <li class="list">Example: 2022-02-19T00:00:15</li>
</ul><p class="description">The time of the measurement</p>

<h3 class="h3">Heart.heart_rate_samples.value</h3>
<ul class="list-wrapper">
    <li class="list">Type: Int</li>
    <li class="list">Unit: Beats per minute</li>
    <li class="list">Example: 156</li>
</ul><p class="description">Heart rate value recorded for that time, in beats per minute. Each entry is a representative sample of the previous 15 seconds from the given time</p>

<h3 class="h3">Heart.heart_rate_variability.day_hrv</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Unit: Milliseconds (ms)</li>
    <li class="list">Example: 39.657</li>
</ul><p class="description">The Root Mean Square of Successive Differences (RMSSD) between heart beats. It measures short-term variability in the user’s daily heart rate in milliseconds (ms).</p>

<h3 class="h3">Heart.heart_rate_variability.sleep_hrv</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Unit: Milliseconds (ms)</li>
    <li class="list">Example: 42.157</li>
</ul><p class="description">The Root Mean Square of Successive Differences (RMSSD) between heart beats. It measures short-term variability in the user’s heart rate while in deep sleep, in milliseconds (ms).</p>

<h3 class="h3">Heart.intraday_hrv.value.rmssd</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Unit: Milliseconds (ms)</li>
    <li class="list">Example: 28.492</li>
</ul><p class="description">The Root Mean Square of Successive Differences (RMSSD) between heart beats. It measures short-term variability in the user’s heart rate in milliseconds (ms).</p>

<h3 class="h3">Heart.intraday_hrv.value.coverage</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Example: 0.945</li>
</ul><p class="description">Data completeness in terms of the number of interbeat intervals.</p>

<h3 class="h3">Heart.intraday_hrv.value.hf</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Example: 97.61</li>
</ul><p class="description">The power in interbeat interval fluctuations within the high frequency band (0.15 Hz - 0.4 Hz).</p>

<h3 class="h3">Heart.intraday_hrv.value.lf</h3>
<ul class="list-wrapper">
    <li class="list">Type: Float</li>
    <li class="list">Example: 121.196</li>
</ul><p class="description">The power in interbeat interval fluctuations within the low frequency band (0.04 Hz - 0.15 Hz).</p>

<h3 class="h3">Heart.intraday_hrv.time</h3>
<ul class="list-wrapper">
    <li class="list">Type: string</li>
    <li class="list">Format: Date time, YYYY-MM-DDThh:mm:ss</li>
    <li class="list">Example: 2022-02-19T00:00:15</li>
</ul><p class="description">The time of the measurement</p>

<h3 class="h3">Heart.source</h3>
<ul class="list-wrapper">
    <li class="list">Type: String</li>
    <li class="list">Example: fitbit</li>
</ul><p class="description">Data source</p>
﻿
﻿
Did this page help you?
Daily Steps
Goals
Docs powered by
Archbee
TABLE OF CONTENTS
GET
Get heart metrics data