List muscles

Return a cursor-paginated muscle collection, with search and filters for region, figure, and side.

Use the collection to build muscle pickers, exercise filters, and controls that only offer highlights available on the figure currently displayed.

GET https://api.gymassets.dev/v1/muscles

cURL

curl 'https://api.gymassets.dev/v1/muscles?figure=male&side=back' \
  -H "Authorization: Bearer $GA_SECRET_KEY"

Response · application/json 200

{
  "data": [
    {
      "id": "lats",
      "label": "Lats",
      "latin": "latissimus dorsi",
      "region": "back",
      "drawn": [
        { "figure": "female", "side": "back" },
        { "figure": "male", "side": "back" }
      ]
    }
  ],
  "next": "opaque cursor"
}

Query parameters

Parameter	Behavior
`region`	Filter by a value from `/v1/muscle-regions`
`figure`	Filter by a value from `/v1/muscle-figures`
`side`	Filter by a value from `/v1/muscle-sides`
`q`	Search labels, ids, Latin names, and aliases. Every word must match, and a misspelled one is corrected
`cursor`	Continue from the `next` value of a previous response

Filters combine. figure and side filter by artwork coverage rather than anatomy alone. A picker built from them never offers a highlight the current view cannot draw.

Know what a view can highlight

Use drawn to decide what a control may offer. It lists the figure and side combinations that can highlight the muscle, and a combination absent from it is anatomy the view does not show rather than art that is missing.

Page through the collection

next is absent on the final page. Page size is fixed. limit, offset, and page are refused rather than ignored, and a refusal names the parameter in parameter.