> ## 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 plan moment (day) detail

> Client-only. Returns a single day (planMoment) from an active template, enriched with full exercise details in the user's language. Each exercise includes plan-level prescription fields (`sets`, `minReps`, `maxReps`, `rest`, `metric`, `tempo`, `rpe`, `rmPercentage`, `groupId`) as well as library-level metadata (`primaryMuscle`, `secondaryMuscles`, `equipment`, `category`, `isFavourite`). Also returns `isTemplateFavourite` for the requesting client and estimated session duration.

Requires the workout_client_plans:read scope. This operation maps to /app/v1/workout/client/library/template/:templateId/day/:planMomentId 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/template/{templateId}/day/{planMomentId}
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/template/{templateId}/day/{planMomentId}:
    get:
      tags:
        - Workout
      summary: Get plan moment (day) detail
      description: >-
        Client-only. Returns a single day (planMoment) from an active template,
        enriched with full exercise details in the user's language. Each
        exercise includes plan-level prescription fields (`sets`, `minReps`,
        `maxReps`, `rest`, `metric`, `tempo`, `rpe`, `rmPercentage`, `groupId`)
        as well as library-level metadata (`primaryMuscle`, `secondaryMuscles`,
        `equipment`, `category`, `isFavourite`). Also returns
        `isTemplateFavourite` for the requesting client and estimated session
        duration.


        Requires the workout_client_plans:read scope. This operation maps to
        /app/v1/workout/client/library/template/:templateId/day/:planMomentId
        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: >-
        publicWorkoutgetPublicV1WorkoutClientsClientIdLibraryTemplateTemplateIdDayPlanMomentId
      parameters:
        - in: path
          name: templateId
          required: true
          description: Workout template plan id.
          schema:
            type: string
            example: 67f1234567890abcdef1234
        - in: path
          name: planMomentId
          required: true
          description: Embedded plan-moment (day) id.
          schema:
            type: string
            example: 67f1234567890abcdef1234
        - 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: Plan moment detail with enriched exercises and session summary.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1WorkoutClientLibraryTemplateTemplateIdDayPlanMomentIdResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      templateId: 67f1234567890abcdef1234
                      templateName: 4-Day Strength Block
                      templateDescription: Progressive upper/lower split.
                      isTemplateFavourite: false
                      planMomentId: 67f1234567890abcdef1234
                      dayName: Day 1 – Lower Body
                      dayDescription: ''
                      dayOrder: 0
                      totalExercises: 5
                      totalSets: 20
                      estimatedDurationMinutes: 55
                      exercises:
                        - _id: 67f1234567890abcdef1234
                          exerciseId: 67f1234567890abcdef1234
                          name: Barbell Squat
                          description: A compound lower-body movement.
                          thumbnail: https://cdn.example.com/exercises/barbell-squat.jpg
                          primaryMuscle: Quadriceps
                          secondaryMuscles:
                            - Glutes
                            - Hamstrings
                          equipment:
                            - Barbell
                            - Rack
                          category: Strength
                          primaryCategory: Strength
                          secondaryCategories:
                            - Push
                          type: reps
                          sets: 4
                          minReps: 6
                          maxReps: 10
                          metric: ''
                          rest: 90
                          intensity: Medium
                          difficulty: Intermediate
                          notes: ''
                          groupId: ''
                          rpe: 0
                          rpeEnabled: true
                          rmPercentage: 0
                          tempo: '3010'
                          order: 0
                          isFavourite: false
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          description: >-
            Template id is malformed (`INVALID_TEMPLATE_ID`), plan moment id is
            malformed (`INVALID_PLAN_ID`), or company context is missing
            (`COMPANY_ID_REQUIRED`).
          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: >-
            Template was not found (`TEMPLATE_NOT_FOUND`) or the plan moment was
            not found or is deleted (`PLAN_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/template/{templateId}/day/{planMomentId}"
            \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1WorkoutClientLibraryTemplateTemplateIdDayPlanMomentIdResponse200:
      type: object
      properties:
        templateId:
          type: string
          example: 67f1234567890abcdef1234
        templateName:
          type: string
          example: 4-Day Strength Block
        templateDescription:
          type: string
          example: Progressive upper/lower split.
        isTemplateFavourite:
          type: boolean
          example: false
        planMomentId:
          type: string
          example: 67f1234567890abcdef1234
        dayName:
          type: string
          example: Day 1 – Lower Body
        dayDescription:
          type: string
          example: ''
        dayOrder:
          type: integer
          example: 0
        totalExercises:
          type: integer
          example: 5
        totalSets:
          type: integer
          example: 20
        estimatedDurationMinutes:
          type: integer
          example: 55
          description: Rough estimate based on sets, per-set time, and rest periods.
        exercises:
          type: array
          items:
            type: object
            properties:
              _id:
                type: string
                example: 67f1234567890abcdef1234
              exerciseId:
                allOf:
                  - type: string
                    example: 67f1234567890abcdef1234
                nullable: true
                description: '`null` when the row references no valid exercise id.'
              name:
                type: string
                example: Barbell Squat
              description:
                type: string
                example: A compound lower-body movement.
              thumbnail:
                type: string
                example: https://cdn.example.com/exercises/barbell-squat.jpg
              primaryMuscle:
                type: string
                example: Quadriceps
              secondaryMuscles:
                type: array
                items:
                  type: string
                example:
                  - Glutes
                  - Hamstrings
              equipment:
                type: array
                items:
                  type: string
                example:
                  - Barbell
                  - Rack
              category:
                type: string
                example: Strength
                description: Alias of `primaryCategory`, kept for older clients.
              primaryCategory:
                type: string
                example: Strength
              secondaryCategories:
                type: array
                items:
                  type: string
                example:
                  - Push
              type:
                type: string
                enum:
                  - reps
                  - time
                  - distance
                  - bodyweight
                  - assisted_bodyweight
                example: reps
                description: Which metric family this exercise is tracked in.
              sets:
                type: integer
                example: 4
              minReps:
                type: integer
                example: 6
              maxReps:
                type: integer
                example: 10
              metric:
                type: string
                example: ''
                description: Used for time/distance-based exercises.
              rest:
                type: integer
                example: 90
                description: Rest in seconds.
              intensity:
                type: string
                example: Medium
                description: >-
                  From the exercise CATALOG, not the plan prescription — same as
                  searchExercises / getExerciseDetail.
              difficulty:
                type: string
                example: Intermediate
                description: From the exercise catalog, as with `intensity`.
              notes:
                type: string
                example: ''
              groupId:
                type: string
                example: ''
                description: Superset group identifier. Empty string if not in a superset.
              rpe:
                type: number
                example: 0
              rpeEnabled:
                type: boolean
                example: true
                description: >-
                  The per-exercise RPE flag stored on the plan. It has no
                  default, so the key is ABSENT from the response on an exercise
                  where it was never set — treat a missing value as unset rather
                  than as `false`.
              rmPercentage:
                type: number
                example: 0
              tempo:
                type: string
                example: '3010'
              order:
                type: integer
                example: 0
              isFavourite:
                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'
    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.