---
title: "Get step samples"
method: GET
path: "/v3/users/{user-id}/activity-transactions/{transaction-id}/activities/{activity-id}/step-samples"
tags: ["Daily activity (deprecated)"]
---

# Get step samples

`GET /v3/users/{user-id}/activity-transactions/{transaction-id}/activities/{activity-id}/step-samples`

## Request

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

Get activity step samples. Example data can be seen from [appendix](#activity-step-time-series).

## Path parameters

- `user-id` integer, required
- `transaction-id` integer, required
- `activity-id` integer, required

## Response `200`

Return activity step samples.

- ActivityStepSamples: Wrapper model for partner step samples.
  - `date` string: Activity step sample date
  - `interval` integer: Sample interval in minutes.
  - `samples` ActivityStepSample[]: List of individual step sample objects.
    - `steps` integer: Number of steps in sample segment. If element is null, step samples are not available for current segment.
    - `time` string: Start time of sample segment.

## Other responses

- `204`: No content when there is no data available.
- `403`: User has not accepted all mandatory consents.

## Changes

- **2026-02-07** `f197848bba31`: 2 info
  - api tag `Daily activity (deprecated)` added
  - api tag `Daily activity` removed
- **2025-06-04** `5ef2cea678a2`: 3 info
  - added the non-success response with the status `403`
  - added the optional property `date` to the response with the `200` status (media type: application/json)
  - added the optional property `date` to the response with the `200` status (media type: application/xml)

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