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 }
]
}| Resource | Used 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.