Activities

client.activities covers the full activity lifecycle: listing, uploading, editing and deleting activities, plus their streams, intervals, comments, and derived analysis (map, weather, curves, best efforts). List and upload routes are athlete-scoped; single-activity routes address the activity directly by id.

Methods

Examples

List and download

List the last 30 days of activities, pick the newest with a type, and download it as a FIT file and as a GPX file with power extensions.

const client = new IntervalsClient({ apiKey });

const localDate = (d: Date) => `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
const now = new Date(); // one timestamp for both bounds
const monthAgo = new Date(now);
monthAgo.setDate(monthAgo.getDate() - 29);
const newest = localDate(now);
const oldest = localDate(monthAgo);

const activities = await client.activities.listActivities({ oldest, newest });
const activity = activities.find((a) => a.type);

if (!activity) {
  console.log('No activities with a type in the last 30 days');
} else {
  const id = activity.id!;

  const full = await client.activities.getActivity(id);
  console.log(`${full.name ?? id}: ${full.type ?? 'unknown type'}`);

  const fit = await client.activities.downloadFitFile(id);
  console.log(`FIT file: ${fit.length} bytes`);

  const gpx = await client.activities.downloadGPX(id, { power: true });
  console.log(`GPX (first 60 chars): ${gpx.toString('utf8').slice(0, 60)}`);
}
Copy

Interval search

Find activities with 3-10 minute power intervals at 95-130% intensity, and search activities by name or tag.

const client = new IntervalsClient({ apiKey });

const matches = await client.activities.searchIntervals({
  minSecs: 180,
  maxSecs: 600,
  minIntensity: 95,
  maxIntensity: 130,
  type: 'POWER',
  limit: 10,
});

if (matches.length === 0) {
  console.log('No activities with matching power intervals');
} else {
  for (const activity of matches) {
    console.log(`${activity.id}  ${activity.name ?? ''}`);
  }
}

const tempo = await client.activities.searchActivitiesFull('tempo', { limit: 5 });
console.log(`${tempo.length} activit${tempo.length === 1 ? 'y' : 'ies'} matching "tempo"`);
Copy

Streams and intervals

For the newest typed activity in the last year, fetch its watts/heartrate streams, detected intervals, and best efforts.

const client = new IntervalsClient({ apiKey });

const localDate = (d: Date) => `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
const now = new Date(); // one timestamp for both bounds
const yearAgo = new Date(now);
yearAgo.setFullYear(yearAgo.getFullYear() - 1);
const newest = localDate(now);
const oldest = localDate(yearAgo);

const activities = await client.activities.listActivities({ oldest, newest });
const activity = activities.find((a) => a.type);

if (!activity) {
  console.log('No activities with a type in the last year');
} else {
  const id = activity.id!;

  const streams = await client.activities.getStreams(id, ['watts', 'heartrate']);
  for (const stream of streams) {
    console.log(`${stream.type}: ${stream.data?.length ?? 0} sample(s)`);
  }

  const intervals = await client.activities.getIntervals(id);
  console.log(`${intervals.icu_intervals?.length ?? 0} interval(s)`);

  const efforts = await client.activities.getBestEfforts(id);
  console.log(`${efforts.efforts?.length ?? 0} best effort(s)`);
}
Copy

Behaviour notes

• ActivityService.downloadFitFiles sends ids as a comma-joined value, and the live API returns 422 "No activities found" for malformed import stubs. See API behaviour.
• The analytics power-curves route (GET /activity/{id}/power-curves, AnalyticsService.getCurves) returns a 422 with an empty body when an activity cannot serve the requested streams or fatigue variants; see the analytics service page and API behaviour.
• See API behaviour for the cross-service list.