exercises

GetExercisesByEquipments

Filter exercises by equipments with cursor-based pagination.

get/api/v1/exercises/equipments

Request

  • Base URL: https://oss.exercisedb.dev
  • URL: https://oss.exercisedb.dev/api/v1/exercises/equipments
  • Auth: RapidAPIKey (a scheme the document does not define)

Query parameters

equipmentsstring

Filter exercises by required equipment. Use comma-separated values for multiple equipment types.

Example:Barbell,Dumbbell
limitstring

Maximum number of results to return (min: 1, max: 25, default: 10)

Example:10
afterstring

Exercise ID to paginate after (for forward pagination)

beforestring

Exercise ID to paginate before (for backward pagination)

Response

Retrieve exercises by search filters

successboolean required

Indicates whether the request was successful

Example response

{
  "success": true,
  "meta": {
    "total": 1789,
    "hasNextPage": true
  },
  "data": [
    {
      "exerciseId": "EIeI8Vf",
      "name": "barbell bench press",
      "bodyParts": [
        "Chest"
      ],
      "equipments": [
        "Barbell"
      ],
      "targetMuscles": [
        "pectorals"
      ],
      "secondaryMuscles": [
        "deltoids",
        "triceps"
      ],
      "gifUrl": "https://static.exercisedb.dev/media/EIeI8Vf.gif",
      "instructions": [
        "Step:1 Settle onto a bench with your feet planted and your back pressed against the bench.",
        "Step:2 Hold the barbell with palms facing down just beyond shoulder width.",
        "Step:3 Brace the torso and align the wrists with the forearms.",
        "Step:4 Press the weight or handles away while keeping your trunk braced.",
        "Step:5 Keep the wrists stacked and use a shoulder path that feels natural.",
        "Step:6 Lower the weight to its starting height under control before pressing again."
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.