---
title: "Get activity samples for given date"
method: GET
path: "/v3/users/activities/samples/{date}"
tags: ["Daily activity"]
---

# Get activity samples for given date

`GET /v3/users/activities/samples/{date}`

## Request

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

Get users activity samples for given date. Date cannot be older than 365 days from today.

## Path parameters

- `date` string, date, required

## Response `200`

Activity samples for given date.

- 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

- `204`: No content when no activity samples found for given date.
- `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
  - the `activity_zones/samples/items/zone` response's property format changed from `SEDENTARY` to no format for status `200`
- **2026-02-07** `f197848bba31`: 1 info
  - endpoint added

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