> ## Documentation Index > Fetch the complete documentation index at: https://docs.fitsociety.io/llms.txt > Use this file to discover all available pages before exploring further. # Exercise detail — History & Statistics (combined) > History AND Statistics of the exercise detail page in ONE response (the Information tab is served by GET /library/exercises/{exerciseId}). The endpoint no longer branches on a `tab` selector — `history`, `pagination`, `statistics`, and `filters` are all returned together. Scoped to ONE exercise across all the client's logged performances (plan + freestyle). The `exercise` header object matches getExerciseDetail (name/description/media/targetedMuscles/categories/equipment/difficulty/intensity/tags/muscleActivation/muscleBalance/isFavourite). Graph points are returned under `statistics.chart`. History preserves the tracking type, targets and grouping captured for each execution after plan edits. Each history day contains a `data` array of performances. A grouped entry returns `supersetExerciseCount` including itself and `supersetExerciseNames` listing the other recorded group members in execution order; standalone entries return 0 and []. For assisted_bodyweight, lower assistance is better, equal assistance compares higher reps, and completed zero-assistance sets remain valid. Assistance is excluded from lifted-load volume and estimated 1RM. Coach callers pass `clientId`; clients resolve from the token. Requires the workout_progress:read scope. This operation maps to /app/v1/workout/client/library/exercises/:exerciseId/history and retains its Workout V2 permission, feature-flag, and resource-scope checks. The clientId path parameter identifies the client represented by the request context. ## OpenAPI ````yaml /openapi/public-v1.json get /public/v1/workout/clients/{clientId}/library/exercises/{exerciseId}/history openapi: 3.1.0 info: title: FITsociety Public API v1 version: 1.0.0 description: >- Developer Public API endpoints under `/public/v1`. This reference is filtered to OAuth/Bearer Public API resources and excludes provider callback receivers, storefront routes, public widgets, wishlist routes, and access-device validation endpoints. contact: name: FITsociety Engineering servers: - url: https://api.fitsociety.io description: Production security: [] tags: - name: Workout description: >- Workout V2 libraries, programmes, client plans, calendars, sessions, groups, settings and progress. AI operations are excluded. - name: OAuth description: Public API OAuth endpoints for server-to-server client credentials. - name: Health description: Public API token health checks. - name: Platform description: >- Inspect Public API client context, capabilities, scopes, and redacted audit logs. - name: Company Catalog description: Read and manage company profile metadata and locations. - name: Clients description: >- Create and manage clients through the Public API using Bearer access tokens. - name: Coaches description: Retrieve coaches for the authenticated company via integrations. - name: Calendar Events description: Read Public API calendar events. - name: Calendar Templates description: >- Read and manage event types and event templates used by calendar availability and bookings. - name: Calendar Extensions description: >- Read recurring bookings, booking requests, calendar tasks, and availability closure metadata. - name: Availability description: Read bookable availability slots and signed availability tokens. - name: Availability Management description: >- Manage coach and location availability templates used to derive bookable slots. - name: Bookings description: Read and manage Public API bookings. - name: Finance description: >- Read invoices, transactions, products, subscriptions, and memberships with guarded finance writes. - name: Credits description: >- Read company-wide and client-scoped credit allocations, mutations, and guarded credit adjustments. - name: Exports description: >- Create and monitor asynchronous company exports through Public API Bearer endpoints. - name: Webhooks description: >- Manage outbound webhook subscriptions and inspect delivery attempts through Public API Bearer endpoints. - name: Measurements description: Read and write client measurement entries. - name: Progress Photos description: Read client progress photo metadata and short-lived signed media URLs. - name: Forms description: Read, create, update, and archive company form templates. - name: Intakes description: Assign intake forms and read client intake assignments and submissions. - name: Check-ups description: >- Schedule and cancel client check-ups and read their status and submissions. - name: Documents description: >- Read client document and folder metadata, register external document links, update metadata, and archive documents from Public API listings. Binary upload, permanent deletion, and company-wide document management are not exposed. - name: Habits description: Read habits and habit entries. - name: Goals description: Read client goal summaries. - name: Conversations description: >- Read and manage direct and group chat conversations through the Public API. - name: Reports description: Read aggregate attendance, revenue, and retention summaries. paths: /public/v1/workout/clients/{clientId}/library/exercises/{exerciseId}/history: get: tags: - Workout summary: Exercise detail — History & Statistics (combined) description: >- History AND Statistics of the exercise detail page in ONE response (the Information tab is served by GET /library/exercises/{exerciseId}). The endpoint no longer branches on a `tab` selector — `history`, `pagination`, `statistics`, and `filters` are all returned together. Scoped to ONE exercise across all the client's logged performances (plan + freestyle). The `exercise` header object matches getExerciseDetail (name/description/media/targetedMuscles/categories/equipment/difficulty/intensity/tags/muscleActivation/muscleBalance/isFavourite). Graph points are returned under `statistics.chart`. History preserves the tracking type, targets and grouping captured for each execution after plan edits. Each history day contains a `data` array of performances. A grouped entry returns `supersetExerciseCount` including itself and `supersetExerciseNames` listing the other recorded group members in execution order; standalone entries return 0 and []. For assisted_bodyweight, lower assistance is better, equal assistance compares higher reps, and completed zero-assistance sets remain valid. Assistance is excluded from lifted-load volume and estimated 1RM. Coach callers pass `clientId`; clients resolve from the token. Requires the workout_progress:read scope. This operation maps to /app/v1/workout/client/library/exercises/:exerciseId/history and retains its Workout V2 permission, feature-flag, and resource-scope checks. The clientId path parameter identifies the client represented by the request context. operationId: >- publicWorkoutgetPublicV1WorkoutClientsClientIdLibraryExercisesExerciseIdHistory parameters: - in: path name: exerciseId required: true description: Catalog Exercisev2 id. schema: type: string example: 67f1234567890abcdef1234 - in: query name: clientId required: false schema: type: string example: 67f1234567890abcdef1234 description: Required when the caller is a coach. - in: query name: page required: false schema: type: integer minimum: 1 example: 1 description: History pagination. - in: query name: limit required: false schema: type: integer minimum: 1 example: 10 description: History pagination. - in: query name: statsRange required: false schema: type: string enum: - last7days - last1month - last6months - all default: last7days description: >- Statistics chart range. `all` starts at the first completed performance and switches to monthly buckets for longer histories. - in: query name: leaderboardMetric required: false schema: type: string enum: - maxWeight - totalReps - totalTimeSeconds - estimated1RM - totalVolume default: maxWeight description: >- Metric for the Leaderboard tab (the metric-selector dropdown). Invalid/missing → `maxWeight`. - in: query name: leaderboardPage required: false schema: type: integer minimum: 1 example: 1 default: 1 description: Leaderboard pagination (independent of the history `page`). - in: query name: leaderboardLimit required: false schema: type: integer minimum: 10 maximum: 100 example: 10 default: 10 description: >- Leaderboard page size (default 10; independent of the history `limit`). - name: clientId in: path required: true schema: type: string pattern: ^[a-fA-F0-9]{24}$ description: Client in the company bound to the Public API token. responses: '200': description: Combined exercise history, statistics, and leaderboard. content: application/json: schema: allOf: - $ref: '#/components/schemas/PublicApiSuccessResponse' - type: object properties: data: $ref: >- #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutClientLibraryExercisesExerciseIdHistoryResponse200 examples: success: summary: Successful response value: data: exercise: _id: 67f1234567890abcdef1234 name: Dumbbell Bench Press description: Example description defaultType: '' media: - type: image url: https://cdn.example.com/exercises/bench.jpg platform: null videoId: null thumbnail: null duration: null width: 1280 height: 720 targetedMuscles: - string primaryCategory: string secondaryCategories: - string equipment: - string difficulty: string intensity: string tags: - string muscleActivation: total: normalized: {} maxValue: 1 muscleBalance: - muscle: Arms value: 1 normalized: 1 isFavourite: false isClientOwn: false libraryExercise: primaryMuscle: Chest description: Flat horizontal press with controlled tempo. secondaryMuscles: - Shoulders - Triceps primaryJoint: Shoulder difficulty: Intermediate intensity: Above Average equipment: - Barbell - Bench images: - url: https://cdn.example.com/workouts/plan-cover.jpg width: 1280 height: 720 videos: - url: https://cdn.example.com/workouts/demo.mp4 platform: s3 videoId: '' thumbnail: https://cdn.example.com/workouts/demo-thumb.jpg duration: 84 width: 1920 height: 1080 defaultType: reps history: - performanceId: 67f1234567890abcdef1234 sessionId: 67f1234567890abcdef1234 isPersonalRecord: false prVerified: false prRank: null planId: 66f7b8b1e13c8d25f4d3d90a executionContext: mode: superset groupId: superset-bench-row restSeconds: 90 restSource: superset planName: 30-Day High Intensity Belly Burn type: reps date: '2026-07-14T10:00:00.000Z' startedAt: '2026-01-09T07:32:00.000Z' dateLabel: 09 Jan 2026 weekday: Monday isCompleted: true setCount: 4 sets: - setNumber: 1 setType: W rest: 10 reps: 15 weight: 15 timeSeconds: 1 distanceMeters: 1 rpe: 1 completed: true isPersonalRecord: false prVerified: false prRank: 1 repsPlaceholderCoach: 10 weightPlaceholderCoach: 40 timeSecondsPlaceholderCoach: null distanceMetersPlaceholderCoach: null rpePlaceholderCoach: 7 restSecondsPlaceholderCoach: 90 repsPlaceholder: 10 weightPlaceholder: 40 timeSecondsPlaceholder: null distanceMetersPlaceholder: null rpePlaceholder: 7 restSecondsPlaceholder: 90 repsActual: 30 weightActual: 42 timeSecondsActual: null distanceMetersActual: null rpeActual: 8 restSecondsActual: 90 muscleActivation: range: startDate: '2026-07-14T10:00:00.000Z' endDate: '2026-07-14T10:00:00.000Z' total: normalized: {} maxValue: 320 topMuscles: - muscle: chest value: 18 pagination: page: 1 limit: 10 totalPages: 8 totalItems: 78 hasNextPage: true hasPreviousPage: false nextPage: 2 previousPage: null statistics: cards: timesPerformed: 78 totalSets: 456 totalReps: 187 frequencyPerWeek: 2 chart: metric: key: reps label: Reps unit: reps exerciseType: reps aggregation: max direction: higher granularity: day range: startDate: '2026-07-14T10:00:00.000Z' endDate: '2026-07-14T10:00:00.000Z' startDateLabel: 07-28-2026 endDateLabel: 08-20-2026 summary: minimum: 1 average: 1 maximum: 1 points: - date: '2026-07-14T10:00:00.000Z' dateLabel: 07-28-2026 value: 1 label: '2026-01-09' weight: 38.35 volume: 298.6 oneRm: 36.8 weightPer: 12.4 volumePer: 8.7 oneRmPer: 10.1 reps: 12 timeSeconds: 900 distanceMeters: 1500 previousRecords: - performanceId: 67f1234567890abcdef1234 date: '2026-07-14T10:00:00.000Z' dateLabel: 08-20-2026 value: 12 personalRecords: maxWeight: value: 40 unit: kg achievedAt: '2026-07-14T10:00:00.000Z' estimated1RM: value: 46.5 unit: kg achievedAt: '2026-07-14T10:00:00.000Z' maxSetVolume: value: 320 unit: kg achievedAt: '2026-07-14T10:00:00.000Z' maxSessionVolume: value: 1280 unit: kg achievedAt: '2026-07-14T10:00:00.000Z' filters: availableFilters: statsRange: - value: last7days label: Last 7 days leaderboardMetric: - value: totalTimeSeconds label: Time unit: h selectedFilters: statsRange: last7days leaderboardMetric: maxWeight leaderboard: enabled: true hidden: false metric: maxWeight calculationMode: absolute scoreUnit: kg scoreDirection: desc podium: - rank: 4 clientId: 67f1234567890abcdef1234 firstName: Ann lastName: Saris name: Ann Saris image: https://cdn.example.com/clients/ann.jpg value: 180 displayScore: 180 displayValue: 180 kg scoreUnit: kg verificationStatus: verified anonymousAvatar: false isCurrentUser: false data: - rank: 4 clientId: 67f1234567890abcdef1234 firstName: Ann lastName: Saris name: Ann Saris image: https://cdn.example.com/clients/ann.jpg value: 180 displayScore: 180 displayValue: 180 kg scoreUnit: kg verificationStatus: verified anonymousAvatar: false isCurrentUser: false currentUser: rank: 4 clientId: 67f1234567890abcdef1234 firstName: Ann lastName: Saris name: Ann Saris image: https://cdn.example.com/clients/ann.jpg value: 180 displayScore: 180 displayValue: 180 kg scoreUnit: kg verificationStatus: verified anonymousAvatar: false isCurrentUser: false inCurrentPage: true totalParticipants: 156 paginationLeaderboard: page: 1 limit: 10 totalPages: 16 totalItems: 153 hasNextPage: true hasPreviousPage: false nextPage: 2 previousPage: false meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '400': description: >- Validation error. Keys: `INVALID_EXERCISE_ID`, `COMPANY_ID_REQUIRED`, `INVALID_CLIENT_ID`. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: invalidRequest: summary: Invalid request value: error: code: 400 key: request.invalid message: The request is invalid. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '401': $ref: '#/components/schemas/ErrorResponse' content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: missingBearer: summary: Missing Bearer token value: error: code: 401 key: auth.missing_bearer message: Authorization Bearer token is required. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 invalidToken: summary: Invalid or expired token value: error: code: 401 key: auth.invalid_token message: The access token is invalid or expired. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 invalidClient: summary: Inactive or revoked client value: error: code: 401 key: auth.invalid_client message: The Public API client is inactive or revoked. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '403': $ref: '#/components/schemas/ErrorResponse' content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: insufficientScopes: summary: Missing required scope value: error: code: 403 key: scopes.insufficient message: The access token does not include the required scope. details: requiredScopes: - required:scope meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '404': description: Exercise not found / not visible (`EXERCISE_NOT_FOUND`). content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: notFound: summary: Resource not found value: error: code: 404 key: resource.not_found message: The requested Public API resource was not found. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '409': $ref: '#/components/schemas/ErrorResponse' '422': $ref: '#/components/schemas/ErrorResponse' '429': $ref: '#/components/schemas/ErrorResponse' content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: rateLimitExceeded: summary: Rate limit exceeded value: error: code: 429 key: rate_limit.exceeded message: Too many Public API requests. Retry later. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 0 resetSeconds: 1 retryAfterSeconds: 1 '500': description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/PublicApiError' examples: serverInternalError: summary: Unexpected server error value: error: code: 500 key: server.internal_error message: An unexpected Public API server error occurred. meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 security: - PublicBearerAuth: [] x-codeSamples: - lang: cURL label: cURL source: >- curl -X GET "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/library/exercises/{exerciseId}/history" \ -H "Authorization: Bearer " components: schemas: PublicApiSuccessResponse: type: object additionalProperties: false required: - data - meta properties: data: type: object meta: $ref: '#/components/schemas/PublicApiMeta' PublicWorkoutSourceGETAppV1WorkoutClientLibraryExercisesExerciseIdHistoryResponse200: type: object description: >- Combined History + Statistics + Leaderboard (no `tab`): { exercise, libraryExercise, history[], pagination, statistics, filters, leaderboard, paginationLeaderboard }. properties: exercise: type: object description: Same Information-tab object as getExerciseDetail. properties: _id: type: string example: 67f1234567890abcdef1234 name: type: string example: Dumbbell Bench Press description: type: string defaultType: type: string enum: - '' - reps - time - distance example: '' description: Freestyle measurement fallback; `""` = legacy reps inference. media: type: array items: $ref: >- #/components/schemas/PublicWorkoutSourceWorkoutExerciseSearchMedia targetedMuscles: type: array items: type: string primaryCategory: type: string secondaryCategories: type: array items: type: string equipment: type: array items: type: string difficulty: type: string intensity: type: string tags: type: array items: type: string muscleActivation: type: object description: Static library muscle activation for the body visual. properties: total: type: object properties: normalized: type: object additionalProperties: type: number maxValue: type: number example: 1 muscleBalance: type: array description: Radar chart muscle-balance values. items: type: object properties: muscle: type: string example: Arms value: type: number example: 1 normalized: type: number example: 1 isFavourite: type: boolean example: false isClientOwn: type: boolean example: false description: >- Whether the requesting client (or, for a coach caller, the target `clientId`) created this exercise — addedBy === clientId with the Client role. Coach/company/system exercises → false. libraryExercise: $ref: '#/components/schemas/PublicWorkoutSourceWorkoutLibraryExercise' history: type: array description: >- Dated performance entries with plan context and per-set rows. `startedAt` is UTC; clients format the displayed time in the viewer's timezone. items: type: object properties: performanceId: type: string example: 67f1234567890abcdef1234 sessionId: allOf: - type: string example: 67f1234567890abcdef1234 isPersonalRecord: type: boolean example: false description: >- Performance-level PR flag — mirrors this performance's single record set (its heaviest completed set that is a top-3 record). prVerified: type: boolean example: false description: >- Filled (current standing record, prRank 1) vs outlined (older record, prRank 2/3). Mirrors the record set. prRank: type: - integer - 'null' enum: - 1 - 2 - 3 - null example: null description: >- Record rank of this performance's PR set (1–3), or `null` when it has no top-3 record. planId: type: - string - 'null' description: >- Assigned plan id; `null` for freestyle or unlinked performances. executionContext: type: - object - 'null' description: >- Immutable rest and grouping context captured for this performance. Use this instead of the current plan when displaying historical rest; legacy performances return null. properties: mode: type: string enum: - standalone - superset example: superset groupId: type: string example: superset-bench-row restSeconds: type: - number - 'null' minimum: 0 example: 90 restSource: type: string enum: - exercise - superset example: superset planName: type: - string - 'null' example: 30-Day High Intensity Belly Burn description: >- Localized assigned plan name; `null` for freestyle or when the historical plan is unavailable. type: type: string enum: - reps - time - distance - bodyweight - weighted_bodyweight - assisted_bodyweight example: reps description: Resolved tracking type for this performance occurrence. date: type: string format: date-time startedAt: type: - string - 'null' format: date-time example: '2026-01-09T07:32:00.000Z' description: >- Performance start instant in UTC; format it on the client for display. dateLabel: type: string example: 09 Jan 2026 weekday: type: string example: Monday isCompleted: type: boolean example: true setCount: type: integer example: 4 sets: type: array items: type: object properties: setNumber: type: integer example: 1 setType: type: string enum: - 'N' - W - D - F example: W rest: type: - number - 'null' example: 10 reps: type: - number - 'null' example: 15 weight: type: - number - 'null' example: 15 timeSeconds: type: - number - 'null' distanceMeters: type: - number - 'null' rpe: type: - number - 'null' completed: type: boolean example: true isPersonalRecord: type: boolean example: false description: >- True only for a COMPLETED set that is one of the exercise's 3 most-recent records. prVerified: type: boolean example: false description: >- Filled badge (current standing record, prRank 1) when true; outlined badge (an older, since-beaten record — prRank 2 or 3) when false. prRank: type: - integer - 'null' enum: - 1 - 2 - 3 - null example: 1 description: >- Record rank across the exercise's history: 1 = current standing record ("PR 1"), 2/3 = older records since beaten. Capped at 3 — the 4th-oldest record and beyond get no badge. `null` when the set is not a PR. repsPlaceholderCoach: type: - number - string - 'null' example: 10 description: >- The coach's prescribed hint for an empty reps input on this set (WorkoutPlan `setsData`). A range string (`"8-12"`) is allowed. `null` when this exercise type does not track reps, nothing is prescribed, or the entry is freestyle. weightPlaceholderCoach: type: - number - 'null' example: 40 timeSecondsPlaceholderCoach: type: - number - 'null' example: null distanceMetersPlaceholderCoach: type: - number - 'null' example: null rpePlaceholderCoach: type: - number - 'null' example: 7 restSecondsPlaceholderCoach: type: - number - 'null' example: 90 repsPlaceholder: type: - number - string - 'null' example: 10 description: >- The hint to actually show. The coach's `repsPlaceholderCoach` wins wherever it exists; otherwise the client's own stored placeholder (the only source for a freestyle entry). weightPlaceholder: type: - number - 'null' example: 40 timeSecondsPlaceholder: type: - number - 'null' example: null distanceMetersPlaceholder: type: - number - 'null' example: null rpePlaceholder: type: - number - 'null' example: 7 restSecondsPlaceholder: type: - number - 'null' example: 90 repsActual: type: - number - string - 'null' example: 30 description: >- The athlete's ACTUALLY-logged reps for this set (mirrors `reps`), or `null` when they did not log it. Additive: `reps` is unchanged. weightActual: type: - number - 'null' example: 42 description: Actually-logged weight (mirrors `weight`), or `null`. timeSecondsActual: type: - number - 'null' example: null description: Actually-logged time (mirrors `timeSeconds`), or `null`. distanceMetersActual: type: - number - 'null' example: null description: >- Actually-logged distance (mirrors `distanceMeters`), or `null`. rpeActual: type: - number - 'null' example: 8 description: Actually-logged RPE (mirrors `rpe`), or `null`. restSecondsActual: type: - number - 'null' example: 90 description: Actually-logged rest (mirrors `restSeconds`), or `null`. muscleActivation: type: object description: >- Muscle activation for THIS exercise across its ALL-TIME completed history (plan + freestyle) — same block shape as getWorkoutDayPerformanceHistory, stable across pages. Activation concentrates on the exercise's primary and secondary muscles. properties: range: type: object description: >- Span of the exercise's logged history (first → last performance); both null when there is none. properties: startDate: type: string format: date-time nullable: true endDate: type: string format: date-time nullable: true total: type: object properties: normalized: type: object description: Per-muscle activation, normalized; keyed by muscle group. additionalProperties: type: number maxValue: type: number example: 320 topMuscles: type: array items: $ref: >- #/components/schemas/PublicWorkoutSourceWorkoutMuscleActivationTop description: Top-activated muscles, strongest first. pagination: type: object description: History pagination. properties: page: type: integer example: 1 limit: type: integer example: 10 totalPages: type: integer example: 8 totalItems: type: integer example: 78 hasNextPage: type: boolean example: true hasPreviousPage: type: boolean example: false nextPage: type: - integer - 'null' example: 2 previousPage: type: - integer - 'null' example: null statistics: type: object description: Statistics for the selected `statsRange`. properties: cards: type: object properties: timesPerformed: type: integer example: 78 totalSets: type: integer example: 456 totalReps: type: integer example: 187 frequencyPerWeek: type: number example: 2 chart: type: object description: >- Drawer-ready graph. `metric` determines which type-specific value the frontend charts; do not infer its unit or direction from the exercise name. properties: metric: type: object properties: key: type: string enum: - reps - weight - assistance - time - distance example: reps label: type: string example: Reps unit: type: string enum: - reps - kg - s - m example: reps exerciseType: type: string enum: - reps - time - distance - bodyweight - weighted_bodyweight - assisted_bodyweight aggregation: type: string enum: - max - min - sum direction: type: string enum: - higher - lower granularity: type: string example: day range: type: object properties: startDate: type: string format: date-time endDate: type: string format: date-time startDateLabel: type: string example: 07-28-2026 endDateLabel: type: string example: 08-20-2026 summary: type: object properties: minimum: type: - number - 'null' average: type: - number - 'null' maximum: type: - number - 'null' points: type: array items: type: object properties: date: type: string format: date-time dateLabel: type: string example: 07-28-2026 value: type: - number - 'null' description: >- Primary chart value. Assistance uses the minimum completed nonnegative assistance with positive reps in each bucket. Buckets without a qualifying set are omitted from chart.points, while real zero-assistance points are retained. Use metric.direction=lower and metric.aggregation=min. label: type: string example: '2026-01-09' weight: type: - number - 'null' example: 38.35 volume: type: number example: 298.6 oneRm: type: number example: 36.8 weightPer: type: - number - 'null' example: 12.4 volumePer: type: number example: 8.7 oneRmPer: type: number example: 10.1 reps: type: number example: 12 timeSeconds: type: number example: 900 distanceMeters: type: number example: 1500 previousRecords: type: array maxItems: 10 description: >- Most recent completed exercise performances using the selected graph metric. items: type: object properties: performanceId: type: string example: 67f1234567890abcdef1234 date: type: string format: date-time dateLabel: type: string example: 08-20-2026 value: type: number example: 12 personalRecords: type: object properties: maxWeight: type: object properties: value: type: number example: 40 unit: type: string example: kg achievedAt: type: string format: date-time estimated1RM: type: object properties: value: type: number example: 46.5 unit: type: string example: kg achievedAt: type: string format: date-time maxSetVolume: type: object properties: value: type: number example: 320 unit: type: string example: kg achievedAt: type: string format: date-time maxSessionVolume: type: object properties: value: type: number example: 1280 unit: type: string example: kg achievedAt: type: string format: date-time filters: type: object properties: availableFilters: type: object properties: statsRange: type: array items: type: object properties: value: type: string example: last7days label: type: string example: Last 7 days leaderboardMetric: type: array description: >- The 5 leaderboard metric-selector options (drives the leaderboard tab's metric dropdown). items: type: object properties: value: type: string enum: - maxWeight - totalReps - totalTimeSeconds - estimated1RM - totalVolume example: totalTimeSeconds label: type: string example: Time unit: type: string example: h selectedFilters: type: object properties: statsRange: type: string example: last7days leaderboardMetric: type: string example: maxWeight description: >- Currently-selected leaderboard metric (echoes `leaderboardMetric` query). leaderboard: type: object description: >- Leaderboard tab for this exercise. Self-gated by the company leaderboard config (`enabled`) and the client's visibility (`hidden`). Scoped to the exercise across the company. properties: enabled: type: boolean example: true description: '`false` when the company leaderboard is off.' hidden: type: boolean example: false description: '`true` when the client hid themselves from leaderboards.' metric: type: string enum: - maxWeight - totalReps - totalTimeSeconds - estimated1RM - totalVolume example: maxWeight description: The selected metric (echoes `leaderboardMetric`). calculationMode: type: string example: absolute scoreUnit: type: - string - 'null' example: kg description: '`kg` | `reps` | `h` (time). Matches `displayValue`''s unit.' scoreDirection: type: string example: desc podium: type: array description: >- The top 3 by score (always, independent of page). EXCLUDED from `data` — the list starts at rank 4 so the top 3 are never repeated. (The metric-selector options moved to `filters.availableFilters.leaderboardMetric`.) items: type: object properties: rank: type: integer example: 4 clientId: type: string example: 67f1234567890abcdef1234 firstName: type: string example: Ann lastName: type: string example: Saris name: type: string example: Ann Saris image: type: string example: https://cdn.example.com/clients/ann.jpg value: type: - number - 'null' example: 180 displayScore: type: - number - 'null' example: 180 displayValue: type: string example: 180 kg description: >- Preformatted score: "HH:MM h" for time (e.g. "01:24 h"), "N kg" for weight/1RM/volume, "N reps" for reps. scoreUnit: type: - string - 'null' example: kg description: '`kg` | `reps` | `h`.' verificationStatus: type: string enum: - verified - pending - unverified example: verified description: 'Badge: ✓ verified / ⏳ pending / — unverified.' anonymousAvatar: type: boolean example: false isCurrentUser: type: boolean example: false data: type: array description: >- Paginated leaderboard slice BELOW the podium — starts at rank 4 on page 1 (the top 3 live in `podium` and are never repeated here). items: type: object properties: rank: type: integer example: 4 clientId: type: string example: 67f1234567890abcdef1234 firstName: type: string example: Ann lastName: type: string example: Saris name: type: string example: Ann Saris image: type: string example: https://cdn.example.com/clients/ann.jpg value: type: - number - 'null' example: 180 displayScore: type: - number - 'null' example: 180 displayValue: type: string example: 180 kg description: >- Preformatted score: "HH:MM h" for time (e.g. "01:24 h"), "N kg" for weight/1RM/volume, "N reps" for reps. scoreUnit: type: - string - 'null' example: kg description: '`kg` | `reps` | `h`.' verificationStatus: type: string enum: - verified - pending - unverified example: verified description: 'Badge: ✓ verified / ⏳ pending / — unverified.' anonymousAvatar: type: boolean example: false isCurrentUser: type: boolean example: false currentUser: description: >- The current client's own row, ALWAYS returned and pinned statically (even when off the current page); `null` when the client has no entry. `inCurrentPage` = whether it also appears in `data` (false when the client is in the podium). oneOf: - allOf: - type: object properties: rank: type: integer example: 4 clientId: type: string example: 67f1234567890abcdef1234 firstName: type: string example: Ann lastName: type: string example: Saris name: type: string example: Ann Saris image: type: string example: https://cdn.example.com/clients/ann.jpg value: type: - number - 'null' example: 180 displayScore: type: - number - 'null' example: 180 displayValue: type: string example: 180 kg description: >- Preformatted score: "HH:MM h" for time (e.g. "01:24 h"), "N kg" for weight/1RM/volume, "N reps" for reps. scoreUnit: type: - string - 'null' example: kg description: '`kg` | `reps` | `h`.' verificationStatus: type: string enum: - verified - pending - unverified example: verified description: 'Badge: ✓ verified / ⏳ pending / — unverified.' anonymousAvatar: type: boolean example: false isCurrentUser: type: boolean example: false - type: object properties: inCurrentPage: type: boolean example: true - type: 'null' totalParticipants: type: integer example: 156 paginationLeaderboard: type: object description: >- Leaderboard pagination (helpers/pagination). `totalItems` counts the `data` list EXCLUDING the podium top 3 (= totalParticipants − 3), so totalPages is for the scrolling list below the podium. properties: page: type: integer example: 1 limit: type: integer example: 10 totalPages: type: integer example: 16 totalItems: type: integer example: 153 hasNextPage: type: boolean example: true hasPreviousPage: type: boolean example: false nextPage: oneOf: - type: integer - type: boolean example: 2 description: Next page number, or `false` on the last page. previousPage: oneOf: - type: integer - type: boolean example: false PublicApiError: type: object additionalProperties: false required: - error - meta properties: error: type: object additionalProperties: false required: - code - key - message properties: code: type: integer example: 401 key: type: string example: auth.invalid_token message: type: string example: The access token is invalid. details: type: object additionalProperties: true meta: $ref: '#/components/schemas/PublicApiMeta' ErrorResponse: allOf: - $ref: '#/components/schemas/StandardResponse' - example: status: 401 error: true message: MISSING_AUTH PublicApiMeta: type: object additionalProperties: false required: - requestId properties: requestId: type: string description: Stable request correlation id. Mirrors `X-Request-Id` when supplied. example: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: $ref: '#/components/schemas/PublicApiRateLimitMeta' PublicWorkoutSourceWorkoutExerciseSearchMedia: type: object properties: type: type: string enum: - image - video example: image url: type: string example: https://cdn.example.com/exercises/bench.jpg platform: type: - string - 'null' enum: - null - s3 - youtube - tiktok example: null videoId: type: - string - 'null' example: null thumbnail: type: - string - 'null' example: null duration: type: - number - 'null' example: null width: type: - number - 'null' example: 1280 height: type: - number - 'null' example: 720 PublicWorkoutSourceWorkoutLibraryExercise: type: object properties: primaryMuscle: type: string example: Chest description: type: string description: Localized catalog exercise description. example: Flat horizontal press with controlled tempo. secondaryMuscles: type: array items: type: string enum: - Chest - Back - Lats - Traps - Shoulders - Biceps - Triceps - Forearms - Core - Abs - Obliques - Glutes - Quads - Hamstrings - Calves - Adductors - Abductors - Hip Flexors - Full Body - Cardio / Conditioning - Neck - Lower Back example: - Shoulders - Triceps primaryJoint: type: string enum: - '' - Ankle - Combination - Core - Elbow - Fingers - Hip - Knee - Neck - Shoulder - Spine - Wrist example: Shoulder difficulty: type: string enum: - '' - Beginner - Intermediate - Advanced example: Intermediate intensity: type: string enum: - '' - Beginner - Below Average - Average - Above Average - High Intensity example: Above Average equipment: type: array items: type: string enum: - Dumbbells - AdjustableDumbbells - Kettlebell - AdjustableKettlebell - CompetitionKettlebell - Medicineball - SlamBall - WallBall - Weightplate - BumperPlates - FractionalPlates - LoadableDumbbellHandle - Sandbag - StrongmanSandbag - Bulgarianbag - Aquabag - Aquaball - Hydrovest - MagneticBell - Macebell - SteelClub - IndianClub - Barbell - OlympicBarbell - TechniqueBar - EZBar - TrapBar - SafetySquatBar - SwissBar - CamberedBar - AxleBar - Landmine - Bench - FlatBench - AdjustableBench - InclineBench - DeclineBench - SealRowBench - HipThrustBench - BenchPressRack - SquatRack - SquatStand - PowerRack - WallMountedRack - HalfRack - SmithMachine - Monolift - JammerArms - BarbellJack - WeightTree - PlateStorage - DeadliftPlatform - Rig - StrengthMachinesPlateloaded - StrengthMachinesWeightstack - StrengthMachinesPneumatic - MultiGym - LegPressMachine - VerticalLegPressMachine - LeverageSquatMachine - LinearHackSquatMachine - BeltSquatMachine - PendulumSquatMachine - VSquatMachine - HackSquatMachine - LegExtensionMachine - LegCurlMachine - SeatedLegCurlMachine - LyingLegCurlMachine - StandingLegCurlMachine - StandingCalfRaiseMachine - SeatedCalfRaiseMachine - CalfPressMachine - HipThrustMachine - GluteDriveMachine - GluteKickbackMachine - HipExtensionMachine - HipAbductionMachine - HipAdductionMachine - ChestPressMachine - VerticalChestPressMachine - InclineChestPressMachine - DeclineChestPressMachine - IsoLateralChestPressMachine - IsoLateralInclinePressMachine - ShoulderPressMachine - IsoLateralShoulderPressMachine - MultiPressMachine - LateralRaiseMachine - RearDeltMachine - PecDeckMachine - PulloverMachine - LatPulldownMachine - IsoLateralLatPulldownMachine - AssistedPullupMachine - AssistedDipMachine - SeatedDipMachine - SeatedRowMachine - LowRowMachine - HighRowMachine - IsoLateralRowMachine - ChestSupportedRowMachine - TBarRowMachine - BicepsCurlMachine - PreacherCurlMachine - TricepsExtensionMachine - AbCrunchMachine - AbCoasterMachine - RotaryTorsoMachine - BackExtensionMachine - SeatedBackExtensionMachine - HyperextensionBench - ReverseHyper - GHD - Kinesis - Pulley - CableMachine - CableStation - CableColumn - CableCrossover - DualAdjustablePulley - SingleCableTower - FunctionalTrainer - TotalGymGTS - Gymstick - ViPR - RipTrainer - Battlerope - ProwlerSled - FarmersHandles - Yoke - Tire - Sledgehammer - TorqueTank - SledTrack - WallBallTarget - AgilityPoles - MiniHurdles - SprintParachute - PullUpBar - Parallelbars - DipBars - Equalizer - Suspensiontrainer - SuspensionSlingTrainer - GymnasticRings - MonkeyBars - PegBoard - RopeClimb - Wall - StallBars - DoorPullUpBar - PushUpHandles - AbStraps - Boxstep - SoftPlyoBox - Hurdle - Speedladder - Parallettes - NordicBench - SissySquatBench - Cardio - Treadmill - CurvedTreadmill - AirRunner - AssaultRunner - StationaryBike - UprightBike - RecumbentBike - BikeErg - SpinBike - AirBike - Rower - WaterRower - FanRower - ArmErgometer - SkiErg - Elliptical - ArcTrainer - NuStep - StairClimber - StepMill - JacobsLadder - VersaClimber - Bosu - Balanceball - Exerciseball - PilatesTennisball - PilatesRing - YogaMat - YogaBlock - YogaWheel - StretchStrap - MobilityStick - MassageBall - PeanutMassageBall - Airpad - Balanceboard - BalancePad - WobbleBoard - Glidedisc - Foamroller - Elasticbands - TherapyBand - Resistanceband - MiniBand - PullUpAssistBand - Powertube - AnkleWeights - SlantBoard - Vibrationtraining - CableRope - StraightBarAttachment - CurlBarAttachment - LatBarAttachment - TricepsBarAttachment - RowHandle - DHandle - DoubleDHandle - AnkleCuff - CableCuff - LandmineHandle - MagGripAttachment - DipBelt - AbWheel - WristRoller - FatGrip - Chain - DoorAnchor - JumpRope - SpeedRope - WeightedJumpRope - SledHarness - LiftingStraps - LiftingHooks - WristWraps - WeightliftingBelt - Clubbel - Stick - Bodybow - BuddySystem - Multinet - Flowin - Aerialhoop - Dancingpole - Trapeze - HulaHoop - Trampoline - XCO - PilatesReformer - PilatesChair - PilatesCadillac - PilatesBarrel - PilatesSpringboard - BalanceBeam - TreatmentTable - RehabTable - SlideBoard example: - Barbell - Bench images: type: array items: $ref: '#/components/schemas/PublicWorkoutSourceWorkoutImageAsset' videos: type: array items: $ref: '#/components/schemas/PublicWorkoutSourceWorkoutVideoAsset' defaultType: type: string enum: - '' - reps - time - distance description: Optional fallback tracking type for freestyle sessions. example: reps PublicWorkoutSourceWorkoutMuscleActivationTop: type: object required: - muscle - value properties: muscle: type: string example: chest value: type: number example: 18 StandardResponse: type: object properties: status: type: integer example: 200 error: type: boolean example: false message: type: string example: SUCCESS required: - status - error - message PublicApiRateLimitMeta: type: object additionalProperties: false properties: limit: type: integer example: 10 remaining: type: integer example: 9 resetSeconds: type: integer description: Seconds until the current rate limit window resets. example: 1 retryAfterSeconds: type: integer description: Present when the request was rate limited. example: 1 PublicWorkoutSourceWorkoutImageAsset: type: object required: - url properties: url: type: string format: uri example: https://cdn.example.com/workouts/plan-cover.jpg width: type: - number - 'null' example: 1280 height: type: - number - 'null' example: 720 PublicWorkoutSourceWorkoutVideoAsset: type: object required: - url - platform properties: url: type: string format: uri example: https://cdn.example.com/workouts/demo.mp4 platform: type: string enum: - s3 - youtube - tiktok example: s3 videoId: type: string example: '' thumbnail: type: string format: uri example: https://cdn.example.com/workouts/demo-thumb.jpg duration: type: - number - 'null' example: 84 width: type: - number - 'null' example: 1920 height: type: - number - 'null' example: 1080 securitySchemes: PublicBearerAuth: type: http scheme: bearer bearerFormat: Opaque description: >- Public API access token issued by `/public/v1/oauth/token`. Example: `Authorization: Bearer fspt_...`. Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with `403 auth.provider_unavailable`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.