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

# Get cardio load by date

`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.

## Path parameters

- `date` 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)