Browse API Reference

Get equipment

Return a normalized equipment record and the template for its matching artwork URL.

Read one record when you already store an id and need its label, classification, or artwork.

GET https://api.gymassets.dev/v1/equipment/{id}
cURL
curl 'https://api.gymassets.dev/v1/equipment/leg-press-45' \
  -H "Authorization: Bearer $GA_SECRET_KEY"
Response · application/json 200
{
  "id": "leg-press-45",
  "label": "45° leg press sled",
  "category": "machine",
  "kind": "station",
  "loading": ["plate"],
  "ubiquity": "commercial",
  "image": "https://cdn.gymassets.dev/v1/{publishableKey}/equipment/leg-press-45.png"
}

Replace {publishableKey} in image before placing it in an image element. The same id also serves an icon.

Distinguish unknown loading from no loading

An empty loading array means no classification has been recorded. ['none'] means the equipment has deliberately been classified as requiring no external load. Treating those values as equivalent loses the distinction between missing data and a known absence.

Errors

An unknown or retired id returns 404 not_found without an alias fallback.