List equipment
Return cursor-paginated equipment records and combine category, kind, loading, ubiquity, and search filters.
The collection returns complete records, including the image template. Rendering a list takes no further request per row.
https://api.gymassets.dev/v1/equipment curl 'https://api.gymassets.dev/v1/equipment?category=machine&kind=station' \
-H "Authorization: Bearer $GA_SECRET_KEY"{
"data": [
{
"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"
}
],
"next": "opaque cursor"
}Query parameters
| Parameter | Behavior |
|---|---|
category | Filter by /v1/equipment-categories |
kind | Filter by /v1/equipment-kinds |
loading | Filter by /v1/equipment-loadings |
ubiquity | Filter by /v1/equipment-ubiquities |
q | Search labels and ids. Every word must match, and a misspelled one is corrected |
cursor | Continue from a previous response’s next value |
Filters combine. A value outside its vocabulary returns 400 unknown_value with
the accepted values.
Search without exact spelling
q matches every word you give it, in any field and any order — not the phrase. So
?q=flat bench finds flat-bench, and adding a word narrows the result rather than
emptying it. Ten words is the limit, and an eleventh is refused rather than dropped.
A word that matches nothing is corrected to the nearest one that does. ?q=dumbell
returns the dumbbell, and the response says what it changed:
https://api.gymassets.dev/v1/equipment?q=dumbell curl 'https://api.gymassets.dev/v1/equipment?q=dumbell' \
-H "Authorization: Bearer $GA_SECRET_KEY"{
"data": [ "…" ],
"corrected": { "dumbell": "dumbbell" }
}Show what you searched for from corrected rather than repeating the query back.