---
title: "Get Continuous Heart rate samples with range"
method: GET
path: "/v3/users/continuous-heart-rate"
tags: ["Continuous Heart Rate"]
---

# Get Continuous Heart rate samples with range

`GET /v3/users/continuous-heart-rate`

## Request

- Base URL: `https://www.polaraccesslink.com`
- URL: `https://www.polaraccesslink.com/v3/users/continuous-heart-rate`
- Auth: OAuth 2
  - Authorization code: `https://flow.polar.com/oauth2/authorization`
  - Token URL: `https://polarremote.com/v2/oauth2/token` scopes: `accesslink.read_all`
- TypeScript: <https://skmtc.dev/polar-com/apis/polar-accesslink-api/docs/v3/users/continuous-heart-rate/get.ts> (a function with typed inputs; its response is checked against the schema)

Get users continuous heart rate values for given date range. <a href="https://support.polar.com/en/support/the_what_and_how_of_polars_continuous_heart_rate"> Supported devices </a>

## Query parameters

- `from` string, date, required
- `to` string, date, required

## Response `200`

Request was successful.

- ContinuousHeartrate: 5 min average samples of heart rate from the duration of the continuous heart rate measurement. Default time between samples is 5 minutes. There may be periods with samples more often than every 5 minutes. Unit of samples is beats per minute (bpm).
  - `polar_user` string: Absolute link to user owning the continuous heart rate samples
  - `date` string, date: Result date of the Continuous Heart Rate
  - `heart_rate_samples` object[]
    - `heart_rate` integer: Heart rate in beats per minute (bpm).
    - `sample_time` string: Measurement time of heart rate in HH:mm:ss format. Device time used for measurement.

## Other responses

- `400`: Invalid request.
- `401`: Unauthorized.
- `403`: User has not accepted all mandatory consents.

## Changes

- **2026-11-06** `18ce96365320`: 1 breaking, 2 warning
  - the `heart_rate_samples` response's property type changed from `object` to `array` for status `200`
  - removed the optional property `heart_rate_samples/heart_rate` from the response with the `200` status
  - removed the optional property `heart_rate_samples/sample_time` from the response with the `200` status
- **2026-02-07** `f197848bba31`: 2 info
  - api tag `Continuous Heart Rate` added
  - api tag `Continuous Heart Rate (Beta)` removed
- **2025-06-04** `5ef2cea678a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polar-com/apis/polar-accesslink-api/changes/v3/users/continuous-heart-rate/get.md)

---

[API](https://skmtc.dev/polar-com/apis/polar-accesslink-api.md) - [All operations](https://skmtc.dev/polar-com/apis/polar-accesslink-api/llms.txt) - [OpenAPI document](https://skmtc.dev/polar-com/apis/polar-accesslink-api/revisions/18ce96365320?raw)