Get full workout with all exercise data

Retrieve a workout with all exercises fully expanded. This is a convenience endpoint that returns everything in a single call. The api_calls_cost field indicates the equivalent number of individual API calls this response counts as (1 workout + N exercises).

workout_idinteger required

Workout ID

langstring nullable

Response language code (e.g. 'en-us', 'pt-br'). Defaults to 'en-us' when omitted. See GET /languages for the full list. Non-English languages require GROWTH tier or higher (BASIC keys get them in the Playground).

Response

Successful Response

idinteger required

Workout ID

namestring required

Workout name

slugstring required

URL-friendly slug

descriptionstring nullable

Workout description

difficultystring nullable

Difficulty level

goalstring nullable

Workout goal

equipmentstring[]

Equipment needed

muscles_targetedstring[]

Primary muscles targeted

bodymap_malestring nullable

Base bodymap stream URL for male images

bodymap_femalestring nullable

Base bodymap stream URL for female images

api_calls_costinteger required

Number of API calls this response counts as. Equivalent to fetching the workout plus each exercise individually.

Example response

{
  "api_calls_cost": 2,
  "description": "A beginner chest and shoulders workout",
  "difficulty": "Beginner",
  "equipment": [
    "Barbell",
    "Dumbbells"
  ],
  "exercises": [
    {
      "category": "Barbell",
      "difficulty": "Intermediate",
      "exercise": {
        "category": "Barbell",
        "difficulty": "Intermediate",
        "force": "Push",
        "grips": [
          "Overhand"
        ],
        "id": 4,
        "mechanic": "Compound",
        "name": "Barbell Bench Press",
        "primary_muscles": [
          "Chest"
        ],
        "steps": [
          "Lie on a flat bench..."
        ],
        "videos": []
      },
      "reps_or_duration": "reps",
      "reps_or_duration_count": "5-8",
      "sets": "3",
      "sort": 1
    }
  ],
  "goal": "Build muscle",
  "id": 1,
  "muscles_targeted": [
    "Chest",
    "Shoulders"
  ],
  "name": "Beginner Bodybuilder - Chest and Shoulders",
  "slug": "beginner-bodybuilder-chest-and-shoulders"
}

Get full workout with all exercise data

Path parameters

Query parameters

Response

Example response

Changes