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 gear

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": ""
}