API Endpoint: List Awarded Badges

Returns a list of badges that have been awarded, and the user they were awarded to. Certain badges can be earned multiple times.

Request

GET /api/1.0/badge/{badgeid}

Route Parameters

badgeid Required. Integer. The badgeid of the badge to retrieve. Can be obtained from a call to /api/badges.

GET Parameters

offset Optional. Integer. The number of users to skip from the beginning. Range: [0, infinity). Defaults to 0.
limit Optional. Integer. The number of users to include in the response. Range: [1, 200]. Defaults to 20.
jsonp Optional. String. The name of a Javascript function to call with the results. See JSONP.

Example Request

/api/1.0/badge/42

Example Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
   "badge":{
      "badgeid":42,
      "name":"Fellow",
      "type":"silver",
      "category":"badgeGuide",
      "description":"500 edits to ten guides or teardowns",
      "num_users":8
   },
   "users":[
      {
         "userid":1,
         "username":"iRobot",
         "date":1271911632,
         "times_earned":1
      },
      {
         "userid":5,
         "username":"David Patierno",
         "date":1271911632,
         "times_earned":1
      },
      {...}
  ]
}