curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/library/category/{categoryId}" \
-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: 10,
favourites: false,
muscleGroups: ['Quadriceps'],
equipments: ['barbell'],
categories: ['Strength'],
levels: ['Intermediate'],
coaches: [],
search: ''
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/library/category/{categoryId}', 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}/library/category/{categoryId}"
payload = {
"page": 1,
"limit": 10,
"favourites": False,
"muscleGroups": ["Quadriceps"],
"equipments": ["barbell"],
"categories": ["Strength"],
"levels": ["Intermediate"],
"coaches": [],
"search": ""
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"categoryId": "67f1234567890abcdef1234",
"categoryName": "Strength Programs",
"templates": [
{
"_id": "67f1234567890abcdef1234",
"name": "4-Day Strength Block",
"description": "Progressive upper/lower split.",
"thumbnail": "https://cdn.example.com/workouts/plan-cover.jpg",
"difficulty": "Intermediate",
"intensity": "High",
"category": "Strength",
"scheduleMode": "recurring"
}
],
"availableFilters": {
"favourites": [
true,
false
],
"muscleGroups": [
"Quadriceps",
"Chest"
],
"equipments": [
{
"value": "barbell",
"label": "Barbell"
}
],
"categories": [
"Strength",
"Cardio"
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Alex Jansen",
"image": "https://cdn.example.com/coaches/alex.jpg"
}
]
},
"selectedFilters": {
"favourites": false,
"muscleGroups": [],
"equipments": [],
"categories": [],
"levels": [],
"coaches": [],
"search": ""
},
"pagination": {
"page": 1,
"limit": 20,
"totalItems": 5,
"totalPages": 1,
"totalAvailableItems": 1
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Get templates in a category (See All)
Returns a paginated list of template cards for the given workout library category. Accepts the same filter set as the library home endpoint in the request body. availableFilters.coaches is dynamically populated from coaches who created active templates for this company.
Read collections default to 10 records. limit accepts 1 through 100; larger values use 100. Continue with page using the returned pagination metadata. Owned collections have no page ceiling.
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}/library/category/{categoryId}" \
-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: 10,
favourites: false,
muscleGroups: ['Quadriceps'],
equipments: ['barbell'],
categories: ['Strength'],
levels: ['Intermediate'],
coaches: [],
search: ''
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/library/category/{categoryId}', 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}/library/category/{categoryId}"
payload = {
"page": 1,
"limit": 10,
"favourites": False,
"muscleGroups": ["Quadriceps"],
"equipments": ["barbell"],
"categories": ["Strength"],
"levels": ["Intermediate"],
"coaches": [],
"search": ""
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"categoryId": "67f1234567890abcdef1234",
"categoryName": "Strength Programs",
"templates": [
{
"_id": "67f1234567890abcdef1234",
"name": "4-Day Strength Block",
"description": "Progressive upper/lower split.",
"thumbnail": "https://cdn.example.com/workouts/plan-cover.jpg",
"difficulty": "Intermediate",
"intensity": "High",
"category": "Strength",
"scheduleMode": "recurring"
}
],
"availableFilters": {
"favourites": [
true,
false
],
"muscleGroups": [
"Quadriceps",
"Chest"
],
"equipments": [
{
"value": "barbell",
"label": "Barbell"
}
],
"categories": [
"Strength",
"Cardio"
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Alex Jansen",
"image": "https://cdn.example.com/coaches/alex.jpg"
}
]
},
"selectedFilters": {
"favourites": false,
"muscleGroups": [],
"equipments": [],
"categories": [],
"levels": [],
"coaches": [],
"search": ""
},
"pagination": {
"page": 1,
"limit": 20,
"totalItems": 5,
"totalPages": 1,
"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"