Gear
Gear represents equipment used during an activity. The object is returned in summary or detailed representations.
Detailed representation attributes
id: | string |
primary: |
boolean athlete’s default bike/shoes |
name: |
string athlete entered for bikes, generated from brand and model for shoes |
distance: |
float meters |
brand_name: | string |
model_name: | string |
frame_type: |
string bike only 1 -> mtb, 2 -> cross, 3 -> road, 4 -> time trial |
description: | string |
resource_state: |
integer indicates level of detail. Possible values: 2 -> ‘summary’, 3 -> ‘detail’ |
Summary representation attributes
id: | string |
primary: |
boolean athlete’s default bike/shoes |
name: |
string athlete entered for bikes, generated from brand and model for shoes |
distance: |
float meters |
resource_state: |
integer indicates level of detail. Possible values: 2 -> ‘summary’, 3 -> ‘detail’ |
Example bike
{
"id": "b105763",
"primary": false,
"name": "Cannondale TT",
"distance": 476612.8,
"resource_state": 3,
"brand_name": "Cannondale",
"model_name": "Slice",
"frame_type": 4,
"description": "Best bike EVER!!"
}
Example shoes
{
"id": "g138727",
"primary": true,
"name": "Nike Air",
"distance": 88983.1,
"resource_state": 2
}
Retrieve details about a specific item of gear. The requesting athlete must own the gear. At this time it is not possible to view just anyone’s gear type and usage.
Parameters
id: | string required |
Returns a detailed gear representation.
Definition
GET https://www.strava.com/api/v3/gear/:ids
Example request
$ curl -G https://www.strava.com/api/v3/gear/g138727 \
-H "Authorization: Bearer 83ebeabdec09f6670863766f792ead24d61fe3f9"
Example responses
{
"id": "g138727",
"primary": true,
"name": "Nike Air",
"distance": 88983.1,
"resource_state": 3,
"brand_name": "Nike",
"model_name": "Air",
"description": ""
}