cURL

curl -X GET "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/assigned/{templateId}/session-detail" \
  -H "Authorization: Bearer <access_token>"

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/assigned/{templateId}/session-detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/assigned/{templateId}/session-detail"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "client": {
      "_id": "67f1234567890abcdef1234",
      "firstName": "Joseph",
      "lastName": "Quin",
      "fullName": "Joseph Quin",
      "email": "joseph@example.com",
      "image": "https://cdn.example.com/clients/joseph.jpg"
    },
    "membership": {
      "name": "Premium Monthly",
      "status": "Active",
      "startDate": "2026-04-12T10:00:00.000Z",
      "expiresAt": "2026-04-12T10:00:00.000Z"
    },
    "creditBalance": 23,
    "nextTrainingAt": "2026-04-12T10:00:00.000Z",
    "medicalData": {
      "injuries": "Knee replacement L (2023)",
      "medication": "Metformin 500mg",
      "allergies": "None",
      "heartProblem": true,
      "bloodPressureIssue": true,
      "doctorApproved": true,
      "additionalNotes": ""
    },
    "coachNotes": [
      {
        "_id": "67f1234567890abcdef1234",
        "title": "Injury / pain",
        "notes": "Mild knee discomfort after leg press.",
        "tags": [
          "string"
        ],
        "pinned": false,
        "date": "2026-04-12T10:00:00.000Z",
        "editedAt": "2026-04-12T10:00:00.000Z",
        "author": {
          "coachId": "67f1234567890abcdef1234",
          "firstName": "Matthijs",
          "lastName": "Wessels",
          "fullName": "Matthijs Wessels",
          "image": ""
        }
      }
    ],
    "plan": {
      "_id": "67f1234567890abcdef1234",
      "name": "Weekly Strength Program",
      "description": "Progressive overload.",
      "thumbnail": "https://cdn.example.com/workouts/cover.jpg",
      "difficulty": "Intermediate",
      "intensity": "High",
      "category": "Strength",
      "goal": "Strength",
      "schedule": {
        "mode": "multi_week",
        "releasePolicy": "weekly_from_start",
        "startDate": "2026-09-08",
        "timeZone": "Europe/Amsterdam",
        "totalWeeks": 4,
        "layout": "calendar_week",
        "weeks": [
          {
            "weekNumber": 1,
            "days": [
              {
                "weekday": 1,
                "isRestDay": false,
                "items": [
                  {
                    "_id": "67f1234567890abcdef1234",
                    "order": 1,
                    "startTime": "08:30",
                    "plannedDurationMinutes": 45,
                    "status": "today",
                    "plannedDate": "2026-09-08",
                    "scheduledDate": "2026-09-08",
                    "source": "programme",
                    "clientAdjustment": {
                      "action": "moved",
                      "occurrenceDate": "2026-09-08",
                      "scheduledDate": "2026-09-08",
                      "changedAt": null
                    },
                    "canClientRestore": true,
                    "type": "workout",
                    "planMomentId": "67f1234567890abcdef1234"
                  }
                ]
              }
            ]
          }
        ]
      }
    },
    "progress": {
      "total": 6,
      "completed": 2,
      "progressPercentage": 33,
      "isCompleted": false
    },
    "totalDays": 4,
    "schedule": {
      "mode": "multi_week",
      "releasePolicy": "weekly_from_start",
      "startDate": "2026-09-08",
      "timeZone": "Europe/Amsterdam",
      "totalWeeks": 4,
      "layout": "calendar_week",
      "weeks": [
        {
          "weekNumber": 1,
          "days": [
            {
              "weekday": 1,
              "isRestDay": false,
              "items": [
                {
                  "_id": "67f1234567890abcdef1234",
                  "order": 1,
                  "startTime": "08:30",
                  "plannedDurationMinutes": 45,
                  "status": "today",
                  "plannedDate": "2026-09-08",
                  "scheduledDate": "2026-09-08",
                  "source": "programme",
                  "clientAdjustment": {
                    "action": "moved",
                    "occurrenceDate": "2026-09-08",
                    "scheduledDate": "2026-09-08",
                    "changedAt": null
                  },
                  "canClientRestore": true,
                  "type": "workout",
                  "planMomentId": "67f1234567890abcdef1234"
                }
              ]
            }
          ]
        }
      ]
    },
    "weeks": [
      {
        "weekNumber": 2,
        "availableFrom": "2026-09-08",
        "isAvailable": false,
        "progressPercentage": 50,
        "isCompleted": false
      }
    ],
    "days": [
      {
        "planMomentId": "67f1234567890abcdef1234",
        "name": "Day 1 – Upper Body Push & Pull",
        "description": "",
        "dayOrder": 1,
        "order": 0,
        "weekNumber": 1,
        "sessionOrder": 1,
        "progress": {
          "total": 6,
          "completed": 2,
          "progressPercentage": 33,
          "isCompleted": false
        },
        "stats": {
          "durationMinutes": 0,
          "exerciseCount": 0,
          "expectedDurationMinutes": 110,
          "totalVolume": 312,
          "totalReps": 104
        },
        "session": {
          "id": "67f1234567890abcdef1234",
          "status": "in_progress",
          "startedAt": "2026-04-12T10:00:00.000Z",
          "programmeScheduleItemId": "67f1234567890abcdef1234",
          "plannedDate": "2026-09-08"
        },
        "exercises": [
          {
            "type": "exercise",
            "planExerciseId": "67f1234567890abcdef1234",
            "exerciseId": "67f1234567890abcdef1234",
            "name": "Dumbbell Bench Press",
            "thumbnail": "https://cdn.example.com/exercises/bench.jpg",
            "media": [
              {
                "type": "image",
                "url": "https://cdn.example.com/ex/bench.jpg",
                "platform": null,
                "videoId": null,
                "thumbnail": null,
                "duration": null,
                "width": 1080,
                "height": 720
              }
            ],
            "primaryMuscle": "Chest",
            "secondaryMuscles": [
              "Triceps"
            ],
            "equipment": [
              "Dumbbell"
            ],
            "groupId": "",
            "order": 0,
            "isFavourite": false,
            "hasHistory": false,
            "targets": {
              "type": "reps",
              "sets": 4,
              "reps": "8–12",
              "rest": 60,
              "rpe": 8,
              "rmPercentage": 0,
              "tempo": "",
              "notes": "Keep elbows tucked."
            },
            "previousBestSet": "12 × 24kg",
            "performanceId": "67f1234567890abcdef1234",
            "isCompleted": false,
            "clientNotes": "",
            "clientRestSeconds": null,
            "notes": "",
            "sets": [
              {
                "setNumber": 1,
                "setType": "N",
                "displayNumber": 1,
                "displayLabel": "1",
                "previous": "12 × 22kg",
                "reps": 10,
                "weight": 22,
                "timeSeconds": null,
                "distanceMeters": null,
                "rpe": null,
                "completed": false
              }
            ],
            "exerciseCount": 2,
            "rounds": 4,
            "data": [
              {
                "id": "67f1234567890abcdef1234",
                "name": "Barbell Bench Press",
                "primaryMuscle": "Chest",
                "secondaryMuscles": [
                  "Chest"
                ],
                "primaryJoint": "Shoulder",
                "equipment": [
                  "Dumbbells"
                ],
                "difficulty": "Intermediate",
                "intensity": "Above Average",
                "visibility": "Company",
                "tags": [
                  "string"
                ],
                "thumbnail": "https://cdn.example.com/exercises/bench-thumb.jpg"
              }
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    }
  }
}

{
  "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
    }
  }
}

{
  "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
    }
  }
}

{
  "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
    }
  }
}

{
  "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
    }
  }
}

Client plans

Get the assigned-plan session detail (available days)

The coach-facing (and client-facing) “Assigned training day” detail screen. Returns the assigned plan with every currently available/startable day, plus the header/context the screen renders.

client / membership / creditBalance / nextTrainingAt: header chips.
medicalData: the Medical Data row (from the client’s objective questionnaire).
coachNotes[]: the Coach-notes panel (author-enriched; a client caller only sees notes flagged visible to client).
progress: completed active moments across the programme. Recurring sequence days show only active attempts and become ready again after completion. Completion is permanent for multi-week/calendar programmes when an exact plan/moment has any non-deleted completed session, including a zero-exercise moment. Archived/deleted moments are excluded. Partial day progress uses one selected active attempt and never unions attempts.
schedule / weeks[]: the normalized programme schedule and every week’s availability. Future weeks stay in weeks[] with isAvailable=false but are excluded from startable days[].
days[]: currently available days. Each day’s exercises[] is the SAME shape as getClientWorkoutDay (standalone { type:"exercise", …, data:[] } and { type:"superset", …, data:[members] } blocks, plan targets, per-set previous values, prefilled-or-logged sets (prescribed per-set rows prefill only until the client logs; afterwards their saved rows are authoritative — deletions persist and are never re-padded to the plan count), and the client’s own clientNotes/clientRestSeconds), EXTENDED per exercise with targetSnapshot (Today / Last session target / Best PR), nextSessionTarget, and history (weight-progression).

Access: client tokens use their own id; a coach/admin must pass a linked clientId.

Per-set placeholders. Every sets[] row carries twelve extra fields: repsPlaceholderCoach, weightPlaceholderCoach, timeSecondsPlaceholderCoach, distanceMetersPlaceholderCoach, rpePlaceholderCoach, restSecondsPlaceholderCoach, and the same six without the Coach suffix. A placeholder is the greyed hint an EMPTY input shows. · *PlaceholderCoach is the coach’s prescription for that set index (WorkoutPlan setsData). null for a metric this exercise type does not track (a time exercise has no reps hint), for a set beyond the prescribed count, for a metric the coach left blank, and for freestyle, which has no prescription at all. · *Placeholder is the hint to actually show. The coach wins: it is the *PlaceholderCoach value whenever there is one, and falls back to the client’s own stored placeholder only where the coach prescribed nothing. So it is identical to *PlaceholderCoach on any prescribed set, and always reflects the CURRENT prescription — a coach editing 8 reps to 12 changes the hint immediately, with no stale client copy able to outlive it. · The client’s stored placeholder (sent per set on PUT /app/v1/workout/performance/sessions/{sessionId}/exercises/{exerciseId}) is therefore a FALLBACK for sets the coach never prescribed, not an override. Send one only where *PlaceholderCoach is null; sending it elsewhere is accepted but ignored. · Placeholders are never logged work — excluded from every total, volume, PR and completion check — so a hint left showing after a value is cleared does not make the set count. They are emitted on logged rows too, because clearing a logged value is exactly when the hint has to reappear. · Committing a hint. When the athlete marks a set completed without typing, send the shown NUMERIC hint as the real value ({ reps: 22, completed: true }); it then counts as their performance. A RANGE hint ("8-12") must NOT be submitted on a completed set — the client should prompt the athlete to enter a value and skip the call, because a range reaching a completed set is stored as its MINIMUM ("12-24" → 12 reps, 120 volume), silently under-crediting them. An unticked set sends its metric as null with completed: false and simply keeps showing the hint.

Requires the workout_client_plans:read scope. This operation maps to /app/v1/workout/plans/client/assigned/:templateId/session-detail 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.

GET

public

workout

clients

{clientId}

plans

assigned

{templateId}

session-detail

cURL

curl -X GET "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/assigned/{templateId}/session-detail" \
  -H "Authorization: Bearer <access_token>"

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/assigned/{templateId}/session-detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/plans/assigned/{templateId}/session-detail"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "client": {
      "_id": "67f1234567890abcdef1234",
      "firstName": "Joseph",
      "lastName": "Quin",
      "fullName": "Joseph Quin",
      "email": "joseph@example.com",
      "image": "https://cdn.example.com/clients/joseph.jpg"
    },
    "membership": {
      "name": "Premium Monthly",
      "status": "Active",
      "startDate": "2026-04-12T10:00:00.000Z",
      "expiresAt": "2026-04-12T10:00:00.000Z"
    },
    "creditBalance": 23,
    "nextTrainingAt": "2026-04-12T10:00:00.000Z",
    "medicalData": {
      "injuries": "Knee replacement L (2023)",
      "medication": "Metformin 500mg",
      "allergies": "None",
      "heartProblem": true,
      "bloodPressureIssue": true,
      "doctorApproved": true,
      "additionalNotes": ""
    },
    "coachNotes": [
      {
        "_id": "67f1234567890abcdef1234",
        "title": "Injury / pain",
        "notes": "Mild knee discomfort after leg press.",
        "tags": [
          "string"
        ],
        "pinned": false,
        "date": "2026-04-12T10:00:00.000Z",
        "editedAt": "2026-04-12T10:00:00.000Z",
        "author": {
          "coachId": "67f1234567890abcdef1234",
          "firstName": "Matthijs",
          "lastName": "Wessels",
          "fullName": "Matthijs Wessels",
          "image": ""
        }
      }
    ],
    "plan": {
      "_id": "67f1234567890abcdef1234",
      "name": "Weekly Strength Program",
      "description": "Progressive overload.",
      "thumbnail": "https://cdn.example.com/workouts/cover.jpg",
      "difficulty": "Intermediate",
      "intensity": "High",
      "category": "Strength",
      "goal": "Strength",
      "schedule": {
        "mode": "multi_week",
        "releasePolicy": "weekly_from_start",
        "startDate": "2026-09-08",
        "timeZone": "Europe/Amsterdam",
        "totalWeeks": 4,
        "layout": "calendar_week",
        "weeks": [
          {
            "weekNumber": 1,
            "days": [
              {
                "weekday": 1,
                "isRestDay": false,
                "items": [
                  {
                    "_id": "67f1234567890abcdef1234",
                    "order": 1,
                    "startTime": "08:30",
                    "plannedDurationMinutes": 45,
                    "status": "today",
                    "plannedDate": "2026-09-08",
                    "scheduledDate": "2026-09-08",
                    "source": "programme",
                    "clientAdjustment": {
                      "action": "moved",
                      "occurrenceDate": "2026-09-08",
                      "scheduledDate": "2026-09-08",
                      "changedAt": null
                    },
                    "canClientRestore": true,
                    "type": "workout",
                    "planMomentId": "67f1234567890abcdef1234"
                  }
                ]
              }
            ]
          }
        ]
      }
    },
    "progress": {
      "total": 6,
      "completed": 2,
      "progressPercentage": 33,
      "isCompleted": false
    },
    "totalDays": 4,
    "schedule": {
      "mode": "multi_week",
      "releasePolicy": "weekly_from_start",
      "startDate": "2026-09-08",
      "timeZone": "Europe/Amsterdam",
      "totalWeeks": 4,
      "layout": "calendar_week",
      "weeks": [
        {
          "weekNumber": 1,
          "days": [
            {
              "weekday": 1,
              "isRestDay": false,
              "items": [
                {
                  "_id": "67f1234567890abcdef1234",
                  "order": 1,
                  "startTime": "08:30",
                  "plannedDurationMinutes": 45,
                  "status": "today",
                  "plannedDate": "2026-09-08",
                  "scheduledDate": "2026-09-08",
                  "source": "programme",
                  "clientAdjustment": {
                    "action": "moved",
                    "occurrenceDate": "2026-09-08",
                    "scheduledDate": "2026-09-08",
                    "changedAt": null
                  },
                  "canClientRestore": true,
                  "type": "workout",
                  "planMomentId": "67f1234567890abcdef1234"
                }
              ]
            }
          ]
        }
      ]
    },
    "weeks": [
      {
        "weekNumber": 2,
        "availableFrom": "2026-09-08",
        "isAvailable": false,
        "progressPercentage": 50,
        "isCompleted": false
      }
    ],
    "days": [
      {
        "planMomentId": "67f1234567890abcdef1234",
        "name": "Day 1 – Upper Body Push & Pull",
        "description": "",
        "dayOrder": 1,
        "order": 0,
        "weekNumber": 1,
        "sessionOrder": 1,
        "progress": {
          "total": 6,
          "completed": 2,
          "progressPercentage": 33,
          "isCompleted": false
        },
        "stats": {
          "durationMinutes": 0,
          "exerciseCount": 0,
          "expectedDurationMinutes": 110,
          "totalVolume": 312,
          "totalReps": 104
        },
        "session": {
          "id": "67f1234567890abcdef1234",
          "status": "in_progress",
          "startedAt": "2026-04-12T10:00:00.000Z",
          "programmeScheduleItemId": "67f1234567890abcdef1234",
          "plannedDate": "2026-09-08"
        },
        "exercises": [
          {
            "type": "exercise",
            "planExerciseId": "67f1234567890abcdef1234",
            "exerciseId": "67f1234567890abcdef1234",
            "name": "Dumbbell Bench Press",
            "thumbnail": "https://cdn.example.com/exercises/bench.jpg",
            "media": [
              {
                "type": "image",
                "url": "https://cdn.example.com/ex/bench.jpg",
                "platform": null,
                "videoId": null,
                "thumbnail": null,
                "duration": null,
                "width": 1080,
                "height": 720
              }
            ],
            "primaryMuscle": "Chest",
            "secondaryMuscles": [
              "Triceps"
            ],
            "equipment": [
              "Dumbbell"
            ],
            "groupId": "",
            "order": 0,
            "isFavourite": false,
            "hasHistory": false,
            "targets": {
              "type": "reps",
              "sets": 4,
              "reps": "8–12",
              "rest": 60,
              "rpe": 8,
              "rmPercentage": 0,
              "tempo": "",
              "notes": "Keep elbows tucked."
            },
            "previousBestSet": "12 × 24kg",
            "performanceId": "67f1234567890abcdef1234",
            "isCompleted": false,
            "clientNotes": "",
            "clientRestSeconds": null,
            "notes": "",
            "sets": [
              {
                "setNumber": 1,
                "setType": "N",
                "displayNumber": 1,
                "displayLabel": "1",
                "previous": "12 × 22kg",
                "reps": 10,
                "weight": 22,
                "timeSeconds": null,
                "distanceMeters": null,
                "rpe": null,
                "completed": false
              }
            ],
            "exerciseCount": 2,
            "rounds": 4,
            "data": [
              {
                "id": "67f1234567890abcdef1234",
                "name": "Barbell Bench Press",
                "primaryMuscle": "Chest",
                "secondaryMuscles": [
                  "Chest"
                ],
                "primaryJoint": "Shoulder",
                "equipment": [
                  "Dumbbells"
                ],
                "difficulty": "Intermediate",
                "intensity": "Above Average",
                "visibility": "Company",
                "tags": [
                  "string"
                ],
                "thumbnail": "https://cdn.example.com/exercises/bench-thumb.jpg"
              }
            ]
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    }
  }
}

{
  "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
    }
  }
}

{
  "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
    }
  }
}

{
  "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
    }
  }
}

{
  "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
    }
  }
}

Authorizations

Authorization

string

header

required

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.

Path Parameters

templateId

string

required

Assigned workout plan id.

Example:

"67f1234567890abcdef1234"

clientId

string

required

Client in the company bound to the Public API token.

Pattern: ^[a-fA-F0-9]{24}$

Query Parameters

clientId

string

Only for coach/admin callers; clients resolve from the token.

Example:

"67f1234567890abcdef1234"

Response

Assigned-plan session detail (currently available days).

data

object

required

Show child attributes

Workout V2

Health

OAuth

Platform

Company catalog

Clients

Calendar and bookings

Finance

Credits

Progress

Habits

Forms

Documents

Reports

Conversations

Exports

Webhooks

Get the assigned-plan session detail (available days)

Authorizations

Path Parameters

Query Parameters

Response