Skip to main content

Intro

The Exercise Service is the core data layer of the ExerciseDB API. It provides access to a structured, searchable database of over 1,300 exercises, each annotated with detailed metadata.

This service supports filtering and retrieval by key attributes such as body part, target muscle, equipment, and name. Each exercise includes:

  • ✅ Exercise name and ID
  • ✅ Target and secondary muscles
  • ✅ Required equipment
  • ✅ Step-by-step instructions
  • ✅ Difficulty level and category
  • ✅ Short description and recommended use case

All exercise data is returned in a clean, consistent JSON format, optimized for use in mobile apps, training platforms, and fitness automation tools.

🧩 Available Endpoints​

GET /exercises
GET /exercises/bodyPart/{bodyPart}
GET /exercises/bodyPartList
GET /exercises/equipment/{equipment}
GET /exercises/equipmentList
GET /exercises/exercise/{id}
GET /exercises/name/{name}
GET /exercises/target/{target}
GET /exercises/targetList

⚙️ Use Cases​

  • Building searchable exercise libraries
  • Auto-generating workouts by muscle group or equipment
  • Displaying instructional content in fitness apps
  • Enabling filtering by difficulty or training category

📐 Exercise schema​

{
  "id": "string",
  "name": "string",
  "bodyPart": "string",
  "target": "string",
  "equipment": "string",
  "secondaryMuscles": ["string"],
  "instructions": ["string"],
  "description": "string",
  "difficulty": "beginner | intermediate | advanced",
  "category": "strength | cardio | mobility | balance | stretching | plyometrics | rehabilitation"
}

📦 Notes​

  • Pagination and sorting are available on most list endpoints
  • All requests must be authenticated via the Gateway service
  • This service is stateless and performance-optimized for real-time use