curl -X POST "https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-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,
levels: ['Beginner'],
categories: ['Strength'],
coaches: [],
search: ''
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-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}/video-library/category/{categoryId}"
payload = {
"page": 1,
"limit": 10,
"favourites": False,
"levels": ["Beginner"],
"categories": ["Strength"],
"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 & Power",
"videos": [
{
"_id": "67f1234567890abcdef1234",
"title": "Core Fundamentals",
"description": "Learn the basics of core training.",
"url": "https://cdn.example.com/video-library/company123/thumb-en.jpg",
"platform": "s3",
"type": "video",
"duration": 300,
"language": "en",
"level": "Beginner",
"category": "Strength",
"isFavorite": false,
"progress": {
"watchedDuration": 120,
"progressPercentage": 40,
"isCompleted": false,
"lastWatchedAt": "2026-04-12T10:00:00.000Z"
}
}
],
"availableFilters": {
"favourites": [
true,
false
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"categories": [
"Strength",
"Cardio"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Alex Jansen",
"image": "https://cdn.example.com/coaches/alex.jpg"
}
]
},
"selectedFilters": {
"favourites": false,
"levels": [],
"categories": [],
"coaches": [],
"search": ""
},
"pagination": {
"page": 1,
"limit": 10,
"totalItems": 15,
"totalPages": 2,
"totalAvailableItems": 1
}
},
"meta": {
"requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
"rateLimit": {
"limit": 10,
"remaining": 9,
"resetSeconds": 1
},
"idempotency": {
"replayed": false
}
}
}Get all videos in a category (See All)
Returns formatted (single-language) video cards for every published video in the given category, ordered by their category position. Accepts the same filter set as the home endpoint in the request body. Language is always resolved from the client’s profile. An empty category returns videos: [] (200, not 404). availableFilters.coaches is dynamically populated from coaches who have published videos 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}/video-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,
levels: ['Beginner'],
categories: ['Strength'],
coaches: [],
search: ''
})
};
fetch('https://api.fitsociety.io/public/v1/workout/clients/{clientId}/video-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}/video-library/category/{categoryId}"
payload = {
"page": 1,
"limit": 10,
"favourites": False,
"levels": ["Beginner"],
"categories": ["Strength"],
"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 & Power",
"videos": [
{
"_id": "67f1234567890abcdef1234",
"title": "Core Fundamentals",
"description": "Learn the basics of core training.",
"url": "https://cdn.example.com/video-library/company123/thumb-en.jpg",
"platform": "s3",
"type": "video",
"duration": 300,
"language": "en",
"level": "Beginner",
"category": "Strength",
"isFavorite": false,
"progress": {
"watchedDuration": 120,
"progressPercentage": 40,
"isCompleted": false,
"lastWatchedAt": "2026-04-12T10:00:00.000Z"
}
}
],
"availableFilters": {
"favourites": [
true,
false
],
"levels": [
"Beginner",
"Intermediate",
"Advance"
],
"categories": [
"Strength",
"Cardio"
],
"coaches": [
{
"id": "67f1234567890abcdef1234",
"name": "Alex Jansen",
"image": "https://cdn.example.com/coaches/alex.jpg"
}
]
},
"selectedFilters": {
"favourites": false,
"levels": [],
"categories": [],
"coaches": [],
"search": ""
},
"pagination": {
"page": 1,
"limit": 10,
"totalItems": 15,
"totalPages": 2,
"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"