List muscle vocabularies

Discover the accepted muscle regions, figures, and sides before building filters or image controls.

Build region filters and figure or side switches from the API rather than hard-coding their options. Each vocabulary returns every accepted value with the number of records using it, and none of them are paginated.

GET https://api.gymassets.dev/v1/muscle-regions

cURL

curl 'https://api.gymassets.dev/v1/muscle-regions' \
  -H "Authorization: Bearer $GA_SECRET_KEY"

Response · application/json 200

{
  "data": [
    { "id": "back", "count": 5 },
    { "id": "chest", "count": 2 },
    { "id": "lower-arms", "count": 1 },
    { "id": "lower-legs", "count": 3 }
  ]
}

Resource	Used by
`GET /v1/muscle-regions`	`?region=` on `/v1/muscles`
`GET /v1/muscle-figures`	`?figure=` on `/v1/muscles` and the image path
`GET /v1/muscle-sides`	`?side=` on `/v1/muscles` and the image path

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

Show a value that nothing uses yet

A count of zero stays in the response. The value is accepted even when no current record uses it. A control built from this vocabulary does not gain an unexpected option later.