POpolar-com
Sleep

Get Sleep

Changed on

Get Users sleep data for given date.

get/v3/users/sleep/{date}

Request

Path parameters

datestring required

Date of sleep as ISO-8601 date string, example: "2020-01-01"

Response

Request was successful.

polar_userstring

Absolute link to user owning the sleep

datestring date

Result date of the sleep

sleep_start_timestring date-time

Start timestamp of the sleep as ISO-8601 datetime string

sleep_end_timestring date-time

End timestamp of the sleep as ISO-8601 datetime string

device_idstring

Id of the device the sleep was measured with

continuitynumber float

Continuity is an estimate of how continuous the sleep was on a scale of 1.0 – 5.0, where 5.0 reflects uninterrupted sleep. The lower the value the more fragmented the sleep was.

continuity_classinteger

Verbal assessments of sleep continuity Very continuous sleep (5) Continuous sleep (4) Fairly continuous sleep (3) Fairly fragmented sleep (2) Fragmented sleep (1)

light_sleepinteger

Total time in seconds spent in light sleep stage between when you fell asleep and when you woke up. Corresponds to N1+ N2 according to AASM classification.

deep_sleepinteger

Total time in seconds spent in the deep sleep stage between when you fell asleep and when you woke up. Corresponds to N3 according to AASM classification.

rem_sleepinteger

Total time in seconds spent in REM sleep stage between when you fell asleep and when you woke up. REM stands for rapid eye movement.

unrecognized_sleep_stageinteger

Total time in seconds spent in unrecognised sleep stage. Sometimes it's impossible to recognize sleep stages. This might happen when, for example, the wrist strap is not tight enough, or if you sleep on your hand.

sleep_scoreinteger

Sleep score summarizes the amount and quality of your sleep into a single number on a scale of 1 – 100. Sleep score tells you how well you slept compared to the indicators of a good night's sleep based on the current sleep science. It consists of six components; sleep time, long interruptions, continuity, actual sleep, REM sleep, and deep sleep.

total_interruption_durationinteger

The total time in seconds you spent awake between when you fell asleep and when you woke up.

sleep_chargeinteger

Sleep score compared to your usual level from the past 28 days.Scale: much below usual (1) – below usual (2) – usual (3) – above usual (4) – much above usual(5).

sleep_goalinteger

Time goal in seconds for sleep selected by user. A default value of the setting is based on age-related sleep duration recommendations.

sleep_ratinginteger

Numeric value given by user for representing the quality of sleep. Selection scale: Very poorly(1), poorly(2), ok(3), well(4), very well(5). 0 means no value is given.

short_interruption_durationinteger

Total time in seconds of short interruptions. Short interruption is interruption in sleep of less than 90 seconds.

long_interruption_durationinteger

Total time in seconds of long interruptions. Long interruption is interruption in sleep of 90 seconds or more.

sleep_cyclesinteger

Number of sleep cycles.

group_duration_scorenumber float

Sleep score consists of six components that are grouped under three themes. Score for sleep duration theme looks at your sleep time compared to your ‘preferred sleep time’ setting and the age-related duration recommendations. Group duration score ranges from 1.0 to 100.0. It is interpreted as textual feedback: poor, moderate or good amount.

group_solidity_scorenumber float

Sleep score consists of six components that are grouped under three themes. Score for sleep solidity theme is the average of the component scores of long interruptions, continuity and actual sleep. Group solidity score ranges from 1.0 to 100.0. It is interpreted as textual feedback: poor, moderate or good solidity.

group_regeneration_scorenumber float

Sleep score consists of six components that are grouped under three themes. Score for regeneration theme is the average of the scores of REM sleep and deep sleep. Group regeneration score ranges from 1.0 to 100.0. It is interpreted as textual feedback: poor, moderate or good regeneration

hypnogramobject

The time span between when you fell asleep and when you woke up is classified into light, deep or REM sleep, or unrecognised or wake in 30-s epochs.

0 = WAKE, 1 = REM, 2 = LIGHTER NON-REM, 3 = LIGHT NON-REM, 4 = DEEP NON-REM, 5 = UNKNOWN (eg. due to bad skin contact).

heart_rate_samplesobject

5 min average samples of heart rate from the duration of the sleep. Default time between samples is 5 minutes. There may be periods with samples more often than every 5 minutes. Unit of samples is beats per minute (bpm).

Example response

{
  "polar_user": "https://www.polaraccesslink/v3/users/1",
  "date": "2020-01-01",
  "sleep_start_time": "2020-01-01T00:39:07+03:00",
  "sleep_end_time": "2020-01-01T09:19:37+03:00",
  "device_id": "1111AAAA",
  "continuity": 2.1,
  "continuity_class": 2,
  "light_sleep": 1000,
  "deep_sleep": 1000,
  "rem_sleep": 1000,
  "unrecognized_sleep_stage": 1000,
  "sleep_score": 80,
  "total_interruption_duration": 1000,
  "sleep_charge": 3,
  "sleep_goal": 28800,
  "sleep_rating": 3,
  "short_interruption_duration": 500,
  "long_interruption_duration": 300,
  "sleep_cycles": 6,
  "group_duration_score": 100,
  "group_solidity_score": 75,
  "group_regeneration_score": 54.2,
  "hypnogram": {
    "00:39": 2,
    "00:50": 3,
    "01:23": 5
  },
  "heart_rate_samples": {
    "00:41": 76,
    "00:46": 77,
    "00:51": 76
  }
}

Changes