Browse API Reference

List exercise vocabularies

Discover exercise categories, difficulties, postures, movements, grips, and per-muscle or per-equipment coverage before building filters.

Build your filter controls from the API rather than hard-coding their options. Each vocabulary returns every accepted value with the number of live records using it, and none of them are paginated.

GET https://api.gymassets.dev/v1/exercise-difficulties
cURL
curl 'https://api.gymassets.dev/v1/exercise-difficulties' \
  -H "Authorization: Bearer $GA_SECRET_KEY"
Response ยท application/json 200
{
  "data": [
    { "id": "beginner", "label": "Beginner", "count": 527 },
    { "id": "intermediate", "label": "Intermediate", "count": 591 }
  ]
}
ResourceUsed by
GET /v1/exercise-categories?category=
GET /v1/exercise-difficulties?difficulty=
GET /v1/exercise-postures?posture=
GET /v1/exercise-movements?movement=
GET /v1/exercise-grips?grip=
GET /v1/exercise-muscles?muscle=
GET /v1/exercise-equipment?equipment=

exercise-muscles and exercise-equipment count exercises per muscle id and per equipment id โ€” the subjects themselves are listed by /v1/muscles and /v1/equipment.

label is present where the id is not presentable on its own, and absent otherwise.