---
title: "Wrist ECG test result data"
method: GET
path: "/v3/users/biosensing/ecg"
tags: ["Elixir™ Biosensing"]
---

# Wrist ECG test result data

`GET /v3/users/biosensing/ecg`

## Request

- Base URL: `https://www.polaraccesslink.com`
- URL: `https://www.polaraccesslink.com/v3/users/biosensing/ecg`
- 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/biosensing/ecg/get.ts> (a function with typed inputs; its response is checked against the schema)

Get user's wrist ECG test result data for last 28 days or for given date range. Maximum date range between from and to cannot be more than 28 days.

## Query parameters

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

## Response `200`

Request was successful.

- EcgTestResult[]
  - `source_device_id` string
  - `test_time` integer
  - `time_zone_offset` integer
  - `average_heart_rate_bpm` integer
  - `heart_rate_variability_ms` number, float
  - `heart_rate_variability_level` 'ECG_HRV_LEVEL_NO_BASELINE' | 'ECG_HRV_LEVEL_BELOW_USUAL' | 'ECG_HRV_LEVEL_USUAL' | 'ECG_HRV_LEVEL_ABOVE_USUAL'
  - `rri_ms` number, float
  - `pulse_transit_time_systolic_ms` number, float
  - `pulse_transit_time_diastolic_ms` number, float
  - `pulse_transit_time_quality_index` number, float
  - `samples` EcgSample[]
    - `recording_time_delta_ms` integer
    - `amplitude_mv` number, float
  - `quality_measurements` QualityMeasurement[]
    - `recording_time_delta_ms` integer
    - `quality_level` 'ECG_QUALITY_UNKNOWN' | 'ECG_QUALITY_NO_CONTACT' | 'ECG_QUALITY_LOW' | 'ECG_QUALITY_HIGH'

## Other responses

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

## Changes

- **2026-11-06** `18ce96365320`: 1 breaking
  - the `items/average_heart_rate_bpm` response's property format changed from `uint32` to `int32` for status `200`
- **2026-02-07** `f197848bba31`: 2 info
  - api tag `Elixir&trade; Biosensing` added
  - api tag `Elixir&trade; Biosensing (Beta)` removed
- **2025-06-04** `5ef2cea678a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polar-com/apis/polar-accesslink-api/changes/v3/users/biosensing/ecg/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)