Activities

One activity, with its load, power and speed bests and route

get/activities/{id}

Request

  • Base URL: https://bodylab.lol/api/v1
  • URL: https://bodylab.lol/api/v1/activities/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Opaque identifier.

Headers

X-Client-Platformstring

The native client's platform, e.g. ios. Server-side and non-native callers omit it.

X-Client-Versionstring

The native client's own semver version. With X-Client-Platform, a version below that platform's minimum is refused with CLIENT_UPGRADE_REQUIRED (426).

Response

OK

idstring required

Opaque identifier.

sourcestring required

Where the activity came from. manual (typed in) and file (uploaded) are Body Lab's own; any other value is the service the athlete synced it from.

duplicateOfstring nullable required

Opaque identifier.

namestring nullable required
activityTypestring required

Sport, from the engine's vocabulary (packages/engine/src/sports.ts), e.g. road_biking, running, hiking, strength_training. Known values: road_biking, running, hiking, strength_training, other. Treat unknown values as "other".

typeLabelstring required
startTimestring date-time required

An instant: ISO-8601 with offset, e.g. 2026-09-13T06:30:00Z.

durationSnumber nullable required
elapsedDurationSnumber nullable required
movingDurationSnumber nullable required
distanceMnumber nullable required
elevationGainMnumber nullable required
avgHrinteger nullable required

Beats per minute.

maxHrinteger nullable required

Beats per minute.

avgPowerWinteger nullable required
sessionRpenumber nullable required

Session RPE, 1–10.

notesstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.