cURL

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: 20,
    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": 20,
    "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
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

Client plans

Get templates in a category (See All)

Client-only. 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.

Requires the workout_client_plans:write scope. This operation maps to /app/v1/workout/client/library/category/:categoryId and retains its Workout V2 permission, feature-flag, and resource-scope checks.

The clientId path parameter identifies the client represented by the request context.

POST

public

workout

clients

{clientId}

library

category

{categoryId}

cURL

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: 20,
    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": 20,
    "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
    }
  },
  "meta": {
    "requestId": "4f849d7d-f4f1-45cc-b4b7-3984a3d17f83",
    "rateLimit": {
      "limit": 10,
      "remaining": 9,
      "resetSeconds": 1
    },
    "idempotency": {
      "replayed": false
    }
  }
}

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.

Headers

Idempotency-Key

string

required

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.

Required string length: 1 - 200

Example:

"booking-create-20260714-001"

Path Parameters

categoryId

string

required

Workout library category id.

Example:

"67f1234567890abcdef1234"

clientId

string

required

Client in the company bound to the Public API token.

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

Body

application/json

page

integer

Required range: x >= 1

Example:

1

limit

integer

Required range: 1 <= x <= 100

Example:

20

favourites

boolean

true to restrict to the client's favourited templates.

Example:

false

muscleGroups

string[]

Example:

["Quadriceps"]

equipments

string[]

Example:

["barbell"]

Response

Paginated, filtered template cards for the category.

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 templates in a category (See All)

Authorizations

Headers

Path Parameters

Body

Response