Browse API Reference

List equipment vocabularies

Discover equipment categories, kinds, loading methods, and ubiquity values 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, so a control keeps working as the catalogue grows.

GET https://api.gymassets.dev/v1/equipment-categories
cURL
curl 'https://api.gymassets.dev/v1/equipment-categories' \
  -H "Authorization: Bearer $GA_SECRET_KEY"
Response · application/json 200
{
  "data": [
    { "id": "accessory", "label": "Accessory", "count": 4 },
    { "id": "apparatus", "label": "Apparatus", "count": 27 },
    { "id": "band", "label": "Band", "count": 1 },
    { "id": "cable", "label": "Cable", "count": 10 }
  ]
}
ResourceUsed by
GET /v1/equipment-categories?category=
GET /v1/equipment-kinds?kind=
GET /v1/equipment-loadings?loading=
GET /v1/equipment-ubiquities?ubiquity=

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

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 a new option the day one record is classified.