---
title: "List Nightly Recharges"
method: GET
path: "/v3/users/nightly-recharge"
tags: ["Nightly Recharge"]
---

# List Nightly Recharges

`GET /v3/users/nightly-recharge`

## Request

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

List Nightly Recharge data of user for the last 28 days.

## Response `200`

Request was successful.

- Recharges: Nightly Recharge list
  - `recharges` NightlyRecharge[]: List of Nightly Recharge objects
    - `polar_user` string: Absolute link to user owning the sleep
    - `date` string, date: Result date of the Nightly Recharge
    - `heart_rate_avg` integer: Average heart rate as beats per minute (bpm) during a 4-hour period starting at 30 minutes after falling asleep.
    - `beat_to_beat_avg` integer: Average time in milliseconds (ms) between successive heart beats during a 4-hour period starting at 30 minutes after falling asleep.
    - `heart_rate_variability_avg` integer: Average variation in the time in milliseconds (ms) between successive heart beats during a 4-hour period starting at 30 minutes after falling asleep. The Heart rate variability is Root Mean Square of Successive Differences (RMSSD) in beat-to-beat intervals.
    - `breathing_rate_avg` number, float: Average breathing rate as breaths per minute (bpm) during a 4-hour period starting at 30 minutes after falling asleep.
    - `nightly_recharge_status` integer: The Nightly Recharge status shows how your body was able to recover from training and stress during the night. Scores for both ANS charge and sleep charge are taken into account. Nightly Recharge status has the following (6-item) scale: very poor (1) – poor (2) – compromised (3) – OK (4) – good (5) – very good (6).
    - `ans_charge` number, float: ANS stands for autonomic nervous system. ANS charge is formed by measuring heart rate, heart rate variability and breathing rate during roughly the first four hours of your sleep. It is formed comparing your last night to your usual levels from the past 28 days. The scale is from -10.0 to +10.0. Around zero is your usual level.
    - `ans_charge_status` integer: ANS charge status = much below usual (1) - below usual (2) - usual (3) - above usual (4) - much above usual (5)
    - `hrv_samples` object: 5-minute average samples of heart rate variability. Unit of samples is milliseconds(ms).
    - `breathing_samples` object: 5-minute average samples of breathing rate. Unit of samples is breaths per minute (bpm).

## Other responses

- `403`: User has not accepted all mandatory consents.

## Changes

- **2025-06-04** `5ef2cea678a2`: 1 info
  - added the non-success response with the status `403`
- **2021-02-25** `425d64c3dd59`: 1 info
  - endpoint added

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