---
title: "Get cardio load by date range"
method: GET
path: "/v3/users/cardio-load/date"
tags: ["Cardio load"]
---

# Get cardio load by date range

`GET /v3/users/cardio-load/date`

## Request

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

Returns cardio load data for selected date range. The response list contains cardio load objects for every day between range even if the cardio load values cannot be calculated, in this case the cardio load status is represented as LOAD_STATUS_NOT_AVAILABLE.

## Query parameters

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

## Response `200`

Request was successful.

- CardioLoad[]: List of cardio loads.
  - `date` string, date: Date in format YYYY-MM-DD.
  - `cardio_load_status` 'LOAD_STATUS_NOT_AVAILABLE' | 'DETRAINING' | 'MAINTAINING' | 'PRODUCTIVE' | 'OVERREACHING' | 'RECOVERY_AFTER_OVERREACHING' | 'PRODUCTIVE_DROPPED_FROM_OVERREACHING' | 'PRODUCTIVE_ALMOST_OVERREACHING' | 'UNRECOGNIZED': Text representation of cardio load status.
  - `cardio_load` number, float: Cardio load (training impulse, TRIMP) shows your cardiac response to a training session.
  - `strain` number, float: Strain shows how much you have strained yourself with training lately. It shows your average daily load from the past 7 days.
  - `tolerance` number, float: Tolerance describes how prepared you are to endure cardio training. It shows your average daily load from the past 28 days.
  - `cardio_load_ratio` number, float: Ratio between strain and tolerance.
  - `cardio_load_level` CardioLoadLevels: Cardio load levels indicate how hard a training session was compared to your session average from the past 90 days.
    - `very_low` number, float
    - `low` number, float
    - `medium` number, float
    - `high` number, float
    - `very-high` number, float

## Other responses

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

## Changes

- **2026-02-07** `f197848bba31`: 3 warning, 2 info
  - added the new `PRODUCTIVE_ALMOST_OVERREACHING` enum value to the `items/cardio_load_status` response property for the response status `200`
  - added the new `PRODUCTIVE_DROPPED_FROM_OVERREACHING` enum value to the `items/cardio_load_status` response property for the response status `200`
  - added the new `RECOVERY_AFTER_OVERREACHING` enum value to the `items/cardio_load_status` response property for the response status `200`
  - api tag `Cardio load` added
  - …1 more
- **2025-06-04** `5ef2cea678a2`: 1 info
  - endpoint added

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