GET /api/badges/:id

get a list of all enabled badges received by a user

Success Response Code: 200

Params

Param name Description
id
optional

id of the badge to retrieve


Value: Must be a Integer

Response Fields

badge[id] unique id of the badge Integer
badge[name] description of the badge String
badge[description] user entered description of badge String
badge[url] system generated URL to access the badge String
badge[images] available sizes (square30, square45, square70, square140) and their associated image URL Hash<String, String>

Example Curl Commands

curl -X GET -v --basic -u "emily@socialcast.com:demo" https://demo.socialcast.com/api/badges/1.json

Examples

GET /badges/74.json
200
{
  "badge": {
    "id": 74,
    "name": "9. Animated",
    "description": "first badge description",
    "url": "https://socialcast.socialcast.test/badges/74",
    "images": {
      "square30": "https://socialcast.socialcast.test/images/thanks/default_badges/visionary_square30.png",
      "square45": "https://socialcast.socialcast.test/images/thanks/default_badges/visionary_square45.png",
      "square70": "https://socialcast.socialcast.test/images/thanks/default_badges/visionary_square70.png",
      "square140": "https://socialcast.socialcast.test/images/thanks/default_badges/visionary_square140.png"
    }
  }
}