> ## 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.

# List unified coach and client workout sessions

> Requires the workout_sessions:read scope. This operation maps to /app/v1/coach/workout/sessions and retains its Workout V2 permission, feature-flag, and resource-scope checks.

The clientId path parameter is resolved inside the company bound to the Public API token when present.



## OpenAPI

````yaml /openapi/public-v1.json get /public/v1/workout/sessions
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/sessions:
    get:
      tags:
        - Workout
      summary: List unified coach and client workout sessions
      description: >-
        Requires the workout_sessions:read scope. This operation maps to
        /app/v1/coach/workout/sessions and retains its Workout V2 permission,
        feature-flag, and resource-scope checks.


        The clientId path parameter is resolved inside the company bound to the
        Public API token when present.
      operationId: publicWorkoutgetPublicV1WorkoutSessions
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            default: 1
          description: One-based result page.
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
          description: Maximum sessions per page.
        - in: query
          name: status
          schema:
            type: string
            enum:
              - all
              - live
              - completed
              - stopped
            default: all
          description: >-
            Unified status filter. Live includes active coach runs and
            in-progress or paused client sessions.
        - in: query
          name: origin
          schema:
            type: string
            enum:
              - all
              - coach
              - client
            default: all
          description: Filter by who started the workout session.
        - in: query
          name: source
          schema:
            type: string
            enum:
              - calendar_event
              - manual
              - auto_assigned_plan
              - manual_assigned_plan
              - template
              - group_workout_template
              - freestyle
              - wod
          description: Optional workout source filter.
        - in: query
          name: completedSince
          schema:
            type: string
            format: date-time
          description: >-
            Lower bound for recent completed or stopped client sessions.
            Defaults to 30 days ago.
      responses:
        '200':
          description: Unified workout sessions fetched.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicApiSuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/PublicWorkoutSourceGETAppV1CoachWorkoutSessionsResponse200
              examples:
                success:
                  summary: Successful response
                  value:
                    data:
                      items:
                        - id: 67f1234567890abcdef1234
                          kind: client_session
                          origin: client
                          openMode: readonly
                          runId: null
                          sessionId: null
                          title: Upper Body - Day 2
                          source: auto_assigned_plan
                          status: in_progress
                          calendarEventId: null
                          manualSessionKey: ''
                          startedAt: null
                          endedAt: null
                          updatedAt: null
                          provenance:
                            origin: coach
                            startedByActorType: coach
                            startedByClientId: null
                            startedByCoachId: null
                            executedByCoachId: null
                            completedByActorType: ''
                            completedByClientId: null
                            completedByCoachId: null
                            endedByActorType: ''
                            endedByClientId: null
                            endedByCoachId: null
                            lastUpdatedByActorType: coach
                            lastUpdatedByClientId: null
                            lastUpdatedByCoachId: null
                          participantCount: 1
                          statusCounts:
                            in_progress: 1
                          participants:
                            - clientId: 67f1234567890abcdef1234
                              sessionId: null
                              sessionStatus: planned
                              workoutSource: auto_assigned_plan
                              sourceLabel: Upper Body - Day 2
                              templateId: null
                              startedAt: null
                              endedAt: null
                              member:
                                clientId: 67f1234567890abcdef1234
                                firstName: Joseph
                                lastName: Quin
                                fullName: Joseph Quin
                                email: joseph@example.com
                                image: https://cdn.example.com/avatar.jpg
                                isActive: true
                                tags:
                                  - _id: 67f1234567890abcdef1234
                                    id: 67f1234567890abcdef1234
                                    name: VIP
                                    label: VIP
                                    color: '#105DFB'
                                memberships:
                                  - _id: 67f1234567890abcdef1234
                                    id: 67f1234567890abcdef1234
                                    membershipId: null
                                    storeModuleMembershipId: null
                                    productName: Premium Monthly
                                    name: Premium Monthly
                                    status: Active
                                    startDate: null
                                    endDate: null
                                    expiresAt: null
                                    nextBillingDate: null
                                    autoRenewCheck: false
                                activeMembership:
                                  _id: 67f1234567890abcdef1234
                                  id: 67f1234567890abcdef1234
                                  membershipId: null
                                  storeModuleMembershipId: null
                                  productName: Premium Monthly
                                  name: Premium Monthly
                                  status: Active
                                  startDate: null
                                  endDate: null
                                  expiresAt: null
                                  nextBillingDate: null
                                  autoRenewCheck: false
                                membershipExpiresAt: null
                                remainingCredits: 23
                                creditBalance: 23
                                nextTrainingAt: null
                                nextTrainingBookingId: null
                                groupWorkoutSession:
                                  sessionId: null
                                  sessionStatus: paused
                                  workoutSource: auto_assigned_plan
                                  sourceLabel: Assigned plan
                                  startedAt: null
                                  endedAt: null
                      pagination:
                        page: 1
                        limit: 20
                        total: 42
                        totalPages: 3
                        hasNextPage: true
                      filters:
                        completedSince: null
                    meta:
                      requestId: 4f849d7d-f4f1-45cc-b4b7-3984a3d17f83
                      rateLimit:
                        limit: 10
                        remaining: 9
                        resetSeconds: 1
        '400':
          $ref: '#/components/schemas/ErrorResponse'
          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':
          description: Coach or company access denied.
          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':
          $ref: '#/components/schemas/ErrorResponse'
          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/sessions" \
              -H "Authorization: Bearer <access_token>"
components:
  schemas:
    PublicApiSuccessResponse:
      type: object
      additionalProperties: false
      required:
        - data
        - meta
      properties:
        data:
          type: object
        meta:
          $ref: '#/components/schemas/PublicApiMeta'
    PublicWorkoutSourceGETAppV1CoachWorkoutSessionsResponse200:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                example: 67f1234567890abcdef1234
              kind:
                type: string
                enum:
                  - coach_run
                  - client_session
                example: client_session
              origin:
                type: string
                enum:
                  - coach
                  - client
                example: client
              openMode:
                type: string
                enum:
                  - manage
                  - readonly
                example: readonly
              runId:
                type:
                  - string
                  - 'null'
                example: null
              sessionId:
                type:
                  - string
                  - 'null'
                example: null
              title:
                type: string
                example: Upper Body - Day 2
              source:
                type: string
                enum:
                  - calendar_event
                  - manual
                  - auto_assigned_plan
                  - manual_assigned_plan
                  - template
                  - group_workout_template
                  - freestyle
                  - wod
                example: auto_assigned_plan
              status:
                type: string
                enum:
                  - active
                  - planned
                  - in_progress
                  - paused
                  - completed
                  - stopped
                  - cancelled
                example: in_progress
              calendarEventId:
                type:
                  - string
                  - 'null'
                example: null
              manualSessionKey:
                type: string
                example: ''
              startedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                example: null
              endedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                example: null
              updatedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                example: null
              provenance:
                type: object
                properties:
                  origin:
                    type: string
                    enum:
                      - ''
                      - client
                      - coach
                      - system
                    example: coach
                  startedByActorType:
                    type: string
                    enum:
                      - ''
                      - client
                      - coach
                      - system
                    example: coach
                  startedByClientId:
                    type:
                      - string
                      - 'null'
                    example: null
                  startedByCoachId:
                    type:
                      - string
                      - 'null'
                    example: null
                  executedByCoachId:
                    type:
                      - string
                      - 'null'
                    example: null
                  completedByActorType:
                    type: string
                    enum:
                      - ''
                      - client
                      - coach
                      - system
                    example: ''
                  completedByClientId:
                    type:
                      - string
                      - 'null'
                    example: null
                  completedByCoachId:
                    type:
                      - string
                      - 'null'
                    example: null
                  endedByActorType:
                    type: string
                    enum:
                      - ''
                      - client
                      - coach
                      - system
                    example: ''
                  endedByClientId:
                    type:
                      - string
                      - 'null'
                    example: null
                  endedByCoachId:
                    type:
                      - string
                      - 'null'
                    example: null
                  lastUpdatedByActorType:
                    type: string
                    enum:
                      - ''
                      - client
                      - coach
                      - system
                    example: coach
                  lastUpdatedByClientId:
                    type:
                      - string
                      - 'null'
                    example: null
                  lastUpdatedByCoachId:
                    type:
                      - string
                      - 'null'
                    example: null
              participantCount:
                type: number
                example: 1
              statusCounts:
                type: object
                additionalProperties:
                  type: number
                example:
                  in_progress: 1
              participants:
                type: array
                items:
                  type: object
                  properties:
                    clientId:
                      type: string
                      example: 67f1234567890abcdef1234
                    sessionId:
                      type:
                        - string
                        - 'null'
                      example: null
                    sessionStatus:
                      type: string
                      enum:
                        - planned
                        - in_progress
                        - paused
                        - completed
                        - stopped
                        - cancelled
                    workoutSource:
                      type: string
                      enum:
                        - calendar_event
                        - manual
                        - auto_assigned_plan
                        - manual_assigned_plan
                        - template
                        - group_workout_template
                        - freestyle
                        - wod
                      example: auto_assigned_plan
                    sourceLabel:
                      type: string
                      example: Upper Body - Day 2
                    templateId:
                      type:
                        - string
                        - 'null'
                      example: null
                    startedAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                      example: null
                    endedAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
                      example: null
                    member:
                      oneOf:
                        - type: object
                          properties:
                            clientId:
                              type: string
                              example: 67f1234567890abcdef1234
                            firstName:
                              type: string
                              example: Joseph
                            lastName:
                              type: string
                              example: Quin
                            fullName:
                              type: string
                              example: Joseph Quin
                            email:
                              type: string
                              example: joseph@example.com
                            image:
                              type: string
                              example: https://cdn.example.com/avatar.jpg
                            isActive:
                              type: boolean
                              example: true
                            tags:
                              type: array
                              items:
                                type: object
                                properties:
                                  _id:
                                    type: string
                                    example: 67f1234567890abcdef1234
                                  id:
                                    type: string
                                    example: 67f1234567890abcdef1234
                                  name:
                                    type: string
                                    example: VIP
                                  label:
                                    type: string
                                    example: VIP
                                  color:
                                    type: string
                                    example: '#105DFB'
                            memberships:
                              type: array
                              items:
                                type: object
                                properties:
                                  _id:
                                    type: string
                                    example: 67f1234567890abcdef1234
                                  id:
                                    type: string
                                    example: 67f1234567890abcdef1234
                                  membershipId:
                                    type:
                                      - string
                                      - 'null'
                                    example: null
                                  storeModuleMembershipId:
                                    type:
                                      - string
                                      - 'null'
                                    example: null
                                  productName:
                                    type: string
                                    example: Premium Monthly
                                  name:
                                    type: string
                                    example: Premium Monthly
                                  status:
                                    type: string
                                    example: Active
                                  startDate:
                                    type:
                                      - string
                                      - 'null'
                                    format: date-time
                                    example: null
                                  endDate:
                                    type:
                                      - string
                                      - 'null'
                                    format: date-time
                                    example: null
                                  expiresAt:
                                    type:
                                      - string
                                      - 'null'
                                    format: date-time
                                    example: null
                                  nextBillingDate:
                                    type:
                                      - string
                                      - 'null'
                                    format: date-time
                                    example: null
                                  autoRenewCheck:
                                    type: boolean
                                    example: false
                            activeMembership:
                              oneOf:
                                - type: object
                                  properties:
                                    _id:
                                      type: string
                                      example: 67f1234567890abcdef1234
                                    id:
                                      type: string
                                      example: 67f1234567890abcdef1234
                                    membershipId:
                                      type:
                                        - string
                                        - 'null'
                                      example: null
                                    storeModuleMembershipId:
                                      type:
                                        - string
                                        - 'null'
                                      example: null
                                    productName:
                                      type: string
                                      example: Premium Monthly
                                    name:
                                      type: string
                                      example: Premium Monthly
                                    status:
                                      type: string
                                      example: Active
                                    startDate:
                                      type:
                                        - string
                                        - 'null'
                                      format: date-time
                                      example: null
                                    endDate:
                                      type:
                                        - string
                                        - 'null'
                                      format: date-time
                                      example: null
                                    expiresAt:
                                      type:
                                        - string
                                        - 'null'
                                      format: date-time
                                      example: null
                                    nextBillingDate:
                                      type:
                                        - string
                                        - 'null'
                                      format: date-time
                                      example: null
                                    autoRenewCheck:
                                      type: boolean
                                      example: false
                                - type: 'null'
                            membershipExpiresAt:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              example: null
                            remainingCredits:
                              type: number
                              example: 23
                            creditBalance:
                              type: number
                              example: 23
                            nextTrainingAt:
                              type:
                                - string
                                - 'null'
                              format: date-time
                              example: null
                            nextTrainingBookingId:
                              type:
                                - string
                                - 'null'
                              example: null
                            groupWorkoutSession:
                              oneOf:
                                - type: object
                                  properties:
                                    sessionId:
                                      type:
                                        - string
                                        - 'null'
                                      example: null
                                    sessionStatus:
                                      type: string
                                      enum:
                                        - pending
                                        - in_progress
                                        - paused
                                        - completed
                                        - stopped
                                        - cancelled
                                        - error
                                      example: paused
                                    workoutSource:
                                      type: string
                                      example: auto_assigned_plan
                                    sourceLabel:
                                      type: string
                                      example: Assigned plan
                                    startedAt:
                                      type:
                                        - string
                                        - 'null'
                                      format: date-time
                                      example: null
                                    endedAt:
                                      type:
                                        - string
                                        - 'null'
                                      format: date-time
                                      example: null
                                - type: 'null'
                        - type: 'null'
        pagination:
          type: object
          properties:
            page:
              type: number
              example: 1
            limit:
              type: number
              example: 20
            total:
              type: number
              example: 42
            totalPages:
              type: number
              example: 3
            hasNextPage:
              type: boolean
              example: true
        filters:
          type: object
          properties:
            completedSince:
              type:
                - string
                - 'null'
              format: date-time
              example: null
    ErrorResponse:
      allOf:
        - $ref: '#/components/schemas/StandardResponse'
        - example:
            status: 401
            error: true
            message: MISSING_AUTH
    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'
    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.