---
title: "List activities"
method: GET
path: "/v3/users/activities"
tags: ["Daily activity"]
---

# List activities

`GET /v3/users/activities`

## Request

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

List users activities available in AccessLink. When no date range is given, activities from the last 28 days are returned. When `from` is given, activities for the specified date range are returned. From date cannot be older than 365 days from today and the maximum range between from and to is 28 days.

## Query parameters

- `from` string, date
- `to` string, date
- `steps` boolean
- `activity_zones` boolean
- `inactivity_stamps` boolean

## Response `200`

List of extended daily activities with all samples.

- ActivitySummaryWithAllSamples[]: Array of activity summaries with all samples. Each item in the array contains a summary of the activity for a specific day, including all samples.
  - `start_time` string: Start time of the activity in UTC
  - `end_time` string: End time of the activity in UTC
  - `active_duration` string: The duration of the activity in ISO8601 format
  - `inactive_duration` string: The duration of the inactivity in ISO8601 format
  - `daily_activity` number, float: Daily activity score / percentage
  - `calories` integer: Total calories burned during the day
  - `active_calories` integer: Active calories burned during the day, excluding BMR
  - `steps` integer: Total number of steps taken during the day
  - `inactivity_alert_count` integer: Number of inactivity alerts received during the day
  - `distance_from_steps` number, float: Distance covered based on steps taken, in meters
  - `samples` ActivityDayWithSamples: Activity day samples.
    - `date` string: Activity day date
    - `steps` ActivitySteps2: Activity step samples for a day. Contains total number of steps and list of individual step samples with time and number of steps in that time period. Note that consecutive repeated (same steps count) samples are filtered out from the list to reduce the payload size. If time between two consecutive samples is larger than interval_ms, one or more samples have been filtered out.
      - `interval_ms` integer: Sample interval in milliseconds.
      - `total_steps` integer: Total number of steps in activity day.
      - `samples` ActivityStepSample2[]: List of individual step sample objects.
        - `steps` integer: Number of steps in sample segment.
        - `timestamp` string: Start time of sample segment.
    - `activity_zones` ActivityZoneSamples2
      - `samples` ActivityZoneSample2[]: List of activity zones samples.
        - `zone` 'SEDENTARY' | 'LIGHT' | 'SLEEP' | 'MODERATE' | 'VIGOROUS': Activity zone type.
        - `timestamp` string
    - `inactivity_stamps` object[]
      - `stamp` string: time of inactivity stamp

## Other responses

- `400`: Invalid or too old date. Cannot be older than 365 days.
- `401`: Unauthorized.
- `403`: User has not accepted all mandatory consents.

## Changes

- **2026-11-06** `18ce96365320`: 1 breaking, 3 info
  - the `items/samples/activity_zones/samples/items/zone` response's property format changed from `SEDENTARY` to no format for status `200`
  - added the new optional `query` request parameter `from`
  - added the new optional `query` request parameter `to`
  - added the non-success response with the status `400`
- **2026-02-07** `f197848bba31`: 1 info
  - endpoint added

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