---
title: "Get available sleep times"
method: GET
path: "/v3/users/sleep/available"
tags: ["Sleep"]
---

# Get available sleep times

`GET /v3/users/sleep/available`

## Request

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

Get the dates with sleep start and end times, where user has sleep data available in the last 28 days.

## Response `200`

Request was successful.

- AvailableSleeps
  - `available` AvailableSleep[]: List of available sleep data
    - `date` string, date: Result date of the sleep
    - `start_time` string, date-time: Start timestamp of the sleep as ISO-8601 datetime string
    - `end_time` string, date-time: End timestamp of the sleep as ISO-8601 datetime string

## 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/sleep/available/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)