---
title: "Get heart rate zones"
method: GET
path: "/v3/users/{user-id}/exercise-transactions/{transaction-id}/exercises/{exercise-id}/heart-rate-zones"
tags: ["Exercises (deprecated)"]
---

# Get heart rate zones

`GET /v3/users/{user-id}/exercise-transactions/{transaction-id}/exercises/{exercise-id}/heart-rate-zones`

## Request

- Base URL: `https://www.polaraccesslink.com`
- URL: `https://www.polaraccesslink.com/v3/users/{user-id}/exercise-transactions/{transaction-id}/exercises/{exercise-id}/heart-rate-zones`
- 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/:user-id/exercise-transactions/:transaction-id/exercises/:exercise-id/heart-rate-zones/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve heart rate zones in training session

## Path parameters

- `user-id` integer, required
- `transaction-id` integer, required
- `exercise-id` integer, required

## Response `200`

Return heart rate zones in training session.

- Zones: List containing the times (in zone) in different heart rate zones (i.e. Heart rate between lower and upper values). Zone is null if no zone information available.
  - `zone` Zone[]: List of heart rate zones.
    - `index` integer: Zone list index
    - `lower-limit` integer: Lower heart-rate boundary of the zone
    - `upper-limit` integer: Upper heart-rate boundary of the zone
    - `in-zone` string: Time duration spent in the zone ISO 8601

## Other responses

- `204`: No content when there is no data available.
- `403`: User has not accepted all mandatory consents.

## Changes

- **2026-02-07** `f197848bba31`: 2 info
  - api tag `Exercises (deprecated)` added
  - api tag `Training data` removed
- **2025-06-04** `5ef2cea678a2`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/polar-com/apis/polar-accesslink-api/changes/v3/users/:user-id/exercise-transactions/:transaction-id/exercises/:exercise-id/heart-rate-zones/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)