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

# Get activity for given date

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

## Request

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

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

## Path parameters

- `date` string, date, required

## Query parameters

- `steps` boolean
- `activity_zones` boolean
- `inactivity_stamps` boolean

## Response `200`

Extended activity summaries with all samples.

- ActivitySummaryWithAllSamples: Activity days with 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

- `204`: No content when no activity 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 `samples/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/: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)