> ## 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. # Get one exercise's record history inside the client's assigned plans > Requires the workout_progress:read scope. This operation maps to /app/v1/workout/plans/client/workout-exercise-history/:exerciseId 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}/plans/workout-exercise-history/{exerciseId} 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}/plans/workout-exercise-history/{exerciseId}: get: tags: - Workout summary: Get one exercise's record history inside the client's assigned plans description: >- Requires the workout_progress:read scope. This operation maps to /app/v1/workout/plans/client/workout-exercise-history/:exerciseId 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: >- publicWorkoutgetPublicV1WorkoutClientsClientIdPlansWorkoutExerciseHistoryExerciseId parameters: - in: path name: exerciseId required: true description: The exercise whose records are being fetched. schema: type: string example: 67f1234567890abcdef1234 - in: query name: clientId schema: type: string example: 67f1234567890abcdef1234 description: >- Required when the caller is a coach/admin; a client token resolves its own id. - in: query name: page schema: type: integer minimum: 1 example: 1 - in: query name: limit schema: type: integer minimum: 10 maximum: 100 example: 10 description: DAYS per page. Clamped to [10, 100] by the shared paginator. - 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: >- The exercise's records inside the client's assigned plans, grouped by day. content: application/json: schema: allOf: - $ref: '#/components/schemas/PublicApiSuccessResponse' - type: object properties: data: $ref: >- #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutPlansClientWorkoutExerciseHistoryExerciseIdResponse200 examples: success: summary: Successful response value: data: exercise: _id: 67f1234567890abcdef1234 name: Dumbbell Bench Press description: Example description thumbnail: string media: - type: image url: https://cdn.example.com/exercises/bench.jpg platform: null videoId: null thumbnail: null duration: null width: 1280 height: 720 primaryMuscle: Chest secondaryMuscles: - Chest equipment: - string defaultType: reps isFavourite: true 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 history: - date: '2026-09-30' dateLabel: Tuesday, 30 Sep 2026 weekday: Tuesday recordCount: 2 records: - performanceId: 67f1234567890abcdef1234 sessionId: 67f1234567890abcdef1234 planId: 67f1234567890abcdef1234 planMomentId: 67f1234567890abcdef1234 programmeScheduleItemId: 67f1234567890abcdef1234 planName: Weekly Strength Program scheduleMode: multi_week dayName: Dumbbell Bench Press workoutIndex: 1 workoutCountInDay: 2 weekNumber: 1 plannedDate: '2026-09-30' startedAt: '2026-04-12T10:00:00.000Z' completedAt: '2026-04-12T10:00:00.000Z' exerciseType: reps isSuperset: true supersetRestPlan: 1 supersetRest: 1 supersetExerciseCount: 1 supersetExerciseNames: - Example name isPersonalRecord: true prVerified: true prRank: 1 targets: type: string sets: 3 reps: 12-15 weight: 1 durationSeconds: 0 distanceMeters: 0 rest: 45 rpe: 8 rmPercentage: 10 tempo: '90' notes: string isCompleted: true setCount: 4 sets: - setNumber: 1 setType: 'N' displayNumber: 1 displayLabel: '1' previous: 12 x 22kg reps: 8 weight: 8 timeSeconds: 1 distanceMeters: 1 restSeconds: 60 rpe: 1 completed: true targetReps: string targetWeight: 1 targetTimeSeconds: 1 targetDistanceMeters: 1 targetRestSeconds: 1 targetRpe: 1 isPersonalRecord: true prVerified: true 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 pagination: page: 1 limit: 10 totalItems: 12 totalPages: 2 hasNextPage: true hasPreviousPage: true meta: requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83 rateLimit: limit: 10 remaining: 9 resetSeconds: 1 '400': description: >- Company context missing (`COMPANY_ID_REQUIRED`), invalid exercise id (`INVALID_EXERCISE_ID`), invalid client id (`INVALID_CLIENT_ID`), or invalid pagination. x-errorCodes: - COMPANY_ID_REQUIRED - INVALID_EXERCISE_ID - 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 (`EXERCISE_NOT_FOUND`). x-errorCodes: - 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}/plans/workout-exercise-history/{exerciseId}" \ -H "Authorization: Bearer " components: schemas: PublicApiSuccessResponse: type: object additionalProperties: false required: - data - meta properties: data: type: object meta: $ref: '#/components/schemas/PublicApiMeta' PublicWorkoutSourceGETAppV1WorkoutPlansClientWorkoutExerciseHistoryExerciseIdResponse200: type: object properties: exercise: type: object description: >- Header for the screen. Resolved by id alone, so a since-retired library exercise still renders in the client's own history. properties: _id: type: string example: 67f1234567890abcdef1234 name: type: string example: Dumbbell Bench Press description: type: string thumbnail: type: string media: type: array items: $ref: >- #/components/schemas/PublicWorkoutSourceWorkoutExerciseSearchMedia description: Images + videos, same shape as elsewhere. primaryMuscle: 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: Chest 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 equipment: type: array items: type: string defaultType: type: string enum: - reps - weighted_bodyweight - assisted_bodyweight - bodyweight - time - distance isFavourite: type: boolean muscleActivation: type: object description: >- Muscle activation for THIS exercise over its ALL-TIME completed history in scope — never capped to a recent window and independent of the page — same block shape as getWorkoutDayPerformanceHistory. Because every performance is the same exercise, activation concentrates on its 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. history: type: array description: One entry per DAY, newest first. items: type: object properties: date: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ example: '2026-09-30' dateLabel: type: string example: Tuesday, 30 Sep 2026 weekday: type: string example: Tuesday recordCount: type: integer example: 2 records: type: array description: Every performance of this exercise that day, newest first. items: type: object properties: performanceId: type: string example: 67f1234567890abcdef1234 sessionId: type: string example: 67f1234567890abcdef1234 planId: type: string example: 67f1234567890abcdef1234 planMomentId: type: string example: 67f1234567890abcdef1234 programmeScheduleItemId: oneOf: - type: string example: 67f1234567890abcdef1234 - type: 'null' planName: type: string example: Weekly Strength Program scheduleMode: type: - string - 'null' enum: - recurring - multi_week - null example: multi_week description: >- Drives the mode badge. `null` only when the plan can no longer be resolved. dayName: type: string example: Dumbbell Bench Press description: >- The plan day (moment) this was performed in, from the session snapshot. workoutIndex: type: integer example: 1 description: >- This session's 1-based position among that plan's workouts on that date — the "Workout 1" / "Workout 2" badge. workoutCountInDay: type: integer example: 2 description: How many workouts of that plan were completed that date. weekNumber: type: - integer - 'null' example: 1 plannedDate: type: string example: '2026-09-30' description: >- The scheduled date for a multi-week occurrence; `""` for a recurring completion. startedAt: type: string format: date-time example: '2026-04-12T10:00:00.000Z' nullable: true completedAt: type: string format: date-time example: '2026-04-12T10:00:00.000Z' nullable: true exerciseType: type: string enum: - reps - weighted_bodyweight - assisted_bodyweight - bodyweight - time - distance isSuperset: type: boolean supersetRestPlan: type: - number - 'null' description: >- The coach's single prescribed rest for the round (seconds); null when unset or standalone. supersetRest: type: - number - 'null' description: >- What the client logged for the round (seconds); null when unset or standalone. supersetExerciseCount: type: integer description: >- Exercises in the round, THIS one included. 0 when standalone. supersetExerciseNames: type: array items: type: string description: >- The OTHER members of the round, so `length` is `supersetExerciseCount - 1`. isPersonalRecord: type: boolean prVerified: type: boolean prRank: type: - integer - 'null' targets: type: object description: >- The coach's prescription chip row, as it stood when this record was performed. properties: type: type: string sets: type: integer example: 3 reps: type: string example: 12-15 weight: type: - number - 'null' durationSeconds: type: number example: 0 distanceMeters: type: number example: 0 rest: type: number example: 45 rpe: type: number example: 8 rmPercentage: type: number example: 10 tempo: type: string example: '90' notes: type: string isCompleted: type: boolean setCount: type: integer example: 4 sets: type: array description: The record table's rows. items: type: object properties: setNumber: type: integer example: 1 setType: type: string enum: - 'N' - W - D - F description: N = normal, W = warm-up, D = drop, F = failure. displayNumber: type: - integer - 'null' description: >- Sequential number across NORMAL sets only; null for W/D/F. displayLabel: type: string example: '1' description: >- The "Set" column text — the number for a normal set, the letter otherwise. previous: type: string example: 12 x 22kg description: >- The same set index of the most recent completed session BEFORE this record. reps: type: - integer - 'null' example: 8 weight: type: - number - 'null' example: 8 timeSeconds: type: - number - 'null' distanceMeters: type: - number - 'null' restSeconds: type: - number - 'null' example: 60 description: >- Always null inside a superset — the round's single rest replaces it. rpe: type: - number - 'null' completed: type: boolean description: Drives the ✓ / ✗ on the row's right. targetReps: type: string targetWeight: type: - number - 'null' targetTimeSeconds: type: - number - 'null' targetDistanceMeters: type: - number - 'null' targetRestSeconds: type: - number - 'null' targetRpe: type: - number - 'null' isPersonalRecord: type: boolean prVerified: type: boolean prRank: type: - integer - 'null' 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`. pagination: type: object description: '`totalItems` counts DAYS.' properties: page: type: integer example: 1 limit: type: integer example: 10 totalItems: type: integer example: 12 totalPages: type: integer example: 2 hasNextPage: type: boolean hasPreviousPage: type: boolean 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 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 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.