---
title: "List recent connector activities"
method: GET
path: "/partner/v1/connectors/{connector}/activities"
---

# List recent connector activities

`GET /partner/v1/connectors/{connector}/activities`

## Request

- Base URL: `https://passport.ego.ist`
- URL: `https://passport.ego.ist/partner/v1/connectors/{connector}/activities`
- Auth: HTTP bearer

Garmin reads bounded activity summaries received after Garmin notifications and kept encrypted for at most 30 days. It reports streams_available: true only when Garmin sample streams are enabled and an unexpired Activity Details callback is retained for the workout's sync window, otherwise false. Strava and Oura use Terra activity reads.

## Path parameters

- `connector` 'garmin' | 'strava' | 'oura', required

## Query parameters

- `days` integer

## Response `200`

Recent activities with stable opaque refs, newest first, up to 100 rows. An empty array is a successful read.

- PartnerActivityIndexResponse
  - `activities` PartnerActivityIndexEntry[], required
    - `ref` string, required
    - `type` union, required: Garmin activity type label, or Terra numeric activity type code. Provider labels are untrusted text. Null when no type is supplied.
      - number
      - string
    - `start_time` string, date-time, required
    - `end_time` string, date-time
    - `duration_seconds` number, nullable, required
    - `distance_meters` number, nullable, required
    - `calories` number, nullable, required
    - `untrusted_name` string, nullable, required
    - `streams_available` boolean, required: Whether this source can serve sample reads in this deployment. Garmin is true only when sample streams are enabled and an unexpired Activity Details callback is retained for the workout's sync window; a particular activity can still have empty or unavailable details.
    - `garmin_attribution` string[]: Display attribution supplied with Garmin data. Preserve with data and derived outputs, visibly adjacent to the view heading and in exports. Garmin alone means no model was supplied.

## Other responses

- `400`: Partner API error. Retry behavior depends on the status and error code.
- `401`: Bearer-token error
- `403`: Partner API error. Retry behavior depends on the status and error code.
- `404`: Partner API error. Retry behavior depends on the status and error code.
- `429`: Partner API error. Retry behavior depends on the status and error code.
- `503`: Partner API error. Retry behavior depends on the status and error code.

---

[API](https://skmtc.dev/ego/apis/ai-passport-partner-api.md) - [All operations](https://skmtc.dev/ego/apis/ai-passport-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ego/apis/ai-passport-partner-api/revisions/d4e46c2809bf?raw)
