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

# List activity samples

`GET /v3/users/activities/samples`

## Request

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

List users activity samples available in AccessLink. When no date range is given, activity samples from the last 28 days are returned. When `from` is given, activity samples 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

## Response `200`

List of users activity samples.

- ActivityDayWithSamples[]: Array of activity days with samples. Each item in the array contains a summary of the activity for a specific day, including all 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/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/samples/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)