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/0.1/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 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": 11, 
      "name": "Nice Answer", 
      "type": "badgeNormal", 
      "category": "badgeAnswers", 
      "description": "Answer with score of five", 
      "num_users": 123
   }, 
   "users": [
      {
         "userid": 2, 
         "username": "Kyle Wiens", 
         "date": 1265322622, 
         "times_earned": 2
      }, 
      {
         "userid": 3, 
         "username": "Chris Cline", 
         "date": 1275235287, 
         "times_earned": 1
      },
      {...}
   ]
}