curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/search" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
page: 1,
limit: 20,
search: '',
favourites: false,
levels: ['Beginner'],
muscleGroups: ['Chest'],
equipments: ['barbell'],
categories: ['Strength'],
coaches: [],
clientOwn: false
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/search', 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}/exercises/search"
payload = {
"page": 1,
"limit": 20,
"search": "",
"favourites": False,
"levels": ["Beginner"],
"muscleGroups": ["Chest"],
"equipments": ["barbell"],
"categories": ["Strength"],
"coaches": [],
"clientOwn": False
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"exercises": [
{
"_id": "67f1234567890abcdef1234",
"name": "Barbell Bench Press",
"thumbnail": "https://cdn.example.com/exercises/bench.jpg",
"type": "s3",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/exercises/bench.jpg",
"platform": null,
"videoId": null,
"thumbnail": null,
"duration": null,
"width": 1080,
"height": 1920
}
],
"primaryMuscle": "Chest",
"secondaryMuscles": [
"Shoulders",
"Triceps"
],
"targetedMuscles": [
"Chest",
"Shoulders",
"Triceps"
],
"difficulty": "Intermediate",
"category": "Strength",
"equipment": [
"Barbell",
"Bench"
],
"exerciseType": "coach",
"isFavourite": false
}
],
"availableFilters": {
"favourites": [
true,
false
],
"clientOwn": [
true,
false
],
"muscleGroups": [
"Chest",
"Back",
"Lats"
],
"equipments": [
{
"value": "barbell",
"label": "Barbell"
}
],
"categories": [
"Agility & Speed",
"Strength",
"Hypertrophy"
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Jane Smith",
"image": "https://cdn.example.com/coaches/jane.jpg"
}
],
"exerciseToTop": null
},
"selectedFilters": {
"favourites": false,
"muscleGroups": [],
"equipments": [],
"categories": [],
"levels": [],
"coaches": [],
"search": "",
"clientOwn": false,
"excludeExerciseIds": [],
"exerciseToTop": null
},
"pagination": {
"page": 1,
"limit": 20,
"totalItems": 48,
"totalPages": 3,
"totalAvailableItems": 1
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}List exercises for client with filters
Returns a paginated list of exercises visible to the client (global, company, and own exercises). All filters are optional and sent in the request body. exerciseType in each item is coach (added by a coach), personal (added by the client), or global (Everyone/Fitsociety visibility). availableFilters.coaches is populated dynamically from exercises visible in this company. Pass skipExercise=<exerciseId> (query or body) to exclude one exercise from the list — e.g. the exercise currently being replaced. An invalid/missing id is ignored. Pass excludeExerciseIds (the multi-value version of skipExercise) to exclude one or more exercises — e.g. movements already selected/prescribed. Both exclude exercises from the results and pagination totals. Pass clientOwn: true to return ONLY the client’s own exercises (same set as /my-exercises). Pass exerciseToTop=<exerciseId> to pin one exercise at page 1 / index 0 — but only if it also satisfies the active filters/visibility; otherwise it is not pinned and does not appear. The pinned item is de-duplicated from the rest of the list. Each item also returns a media array (images + videos, same shape as the exercise history response) and targetedMuscles (primary + secondary, de-duplicated).
Requires the workout_client_plans:write scope and the corresponding Workout features and permissions.
The clientId path parameter identifies a client in the company bound to the Public API token.
curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/search" \
-H "Authorization: Bearer <access_token>" \
-H "Idempotency-Key: <stable_request_key>" \
-H "Content-Type: application/json" \
-d '{}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
page: 1,
limit: 20,
search: '',
favourites: false,
levels: ['Beginner'],
muscleGroups: ['Chest'],
equipments: ['barbell'],
categories: ['Strength'],
coaches: [],
clientOwn: false
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/exercises/search', 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}/exercises/search"
payload = {
"page": 1,
"limit": 20,
"search": "",
"favourites": False,
"levels": ["Beginner"],
"muscleGroups": ["Chest"],
"equipments": ["barbell"],
"categories": ["Strength"],
"coaches": [],
"clientOwn": False
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"exercises": [
{
"_id": "67f1234567890abcdef1234",
"name": "Barbell Bench Press",
"thumbnail": "https://cdn.example.com/exercises/bench.jpg",
"type": "s3",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/exercises/bench.jpg",
"platform": null,
"videoId": null,
"thumbnail": null,
"duration": null,
"width": 1080,
"height": 1920
}
],
"primaryMuscle": "Chest",
"secondaryMuscles": [
"Shoulders",
"Triceps"
],
"targetedMuscles": [
"Chest",
"Shoulders",
"Triceps"
],
"difficulty": "Intermediate",
"category": "Strength",
"equipment": [
"Barbell",
"Bench"
],
"exerciseType": "coach",
"isFavourite": false
}
],
"availableFilters": {
"favourites": [
true,
false
],
"clientOwn": [
true,
false
],
"muscleGroups": [
"Chest",
"Back",
"Lats"
],
"equipments": [
{
"value": "barbell",
"label": "Barbell"
}
],
"categories": [
"Agility & Speed",
"Strength",
"Hypertrophy"
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Jane Smith",
"image": "https://cdn.example.com/coaches/jane.jpg"
}
],
"exerciseToTop": null
},
"selectedFilters": {
"favourites": false,
"muscleGroups": [],
"equipments": [],
"categories": [],
"levels": [],
"coaches": [],
"search": "",
"clientOwn": false,
"excludeExerciseIds": [],
"exerciseToTop": null
},
"pagination": {
"page": 1,
"limit": 20,
"totalItems": 48,
"totalPages": 3,
"totalAvailableItems": 1
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Authorizations
Headers
Required for Public API write requests. Reusing the same key with the same method, path, and body replays the stored successful response; reusing it with a different request returns 409 idempotency.conflict.
1 - 200"booking-create-20260714-001"
Path Parameters
Query Parameters
Body
Exclude one or more exercises from the results (movements already selected/prescribed). Comma-separated string or array of exercise ObjectIds. Aliases also accepted: excludeExerciseId / exerciseIds / exerciseId; also readable from the query string. Invalid id → 400 WORKOUTEXERCISE_EXERCISEID_INVALID. Echoed back in selectedFilters.excludeExerciseIds.
"6925d2764ac340a53e012927,6925d2764ac340a53e012928"
Pin a single exercise to page 1 / index 0. Only pinned if it also satisfies the active filters + visibility (else omitted entirely). De-duplicated from the rest of the list. May also be passed as the exerciseToTop query param. Invalid id → 400 WORKOUTEXERCISE_EXERCISEID_INVALID.
"67f1234567890abcdef1234"