Info Value
Updated on 14 February 2017
Response format JSON
HTTP Methods GET
Response object Item
API Version 1.0

Awards/User/List

Retrieve all awards for a game. With the awards information, it will also tell if the user has achieved that award.

Parameters

Parameter Type Description
user_token
string The user's access token

Response

Returns an array of awards, indexed by the award id.

Element Type Description
award_id integer The ID of the award
id integer The ID of the award
game_id integer The ID of the game
title string The title of the game
description string The description of the award
enabled string The status of the game. It can take 2 values, 1(enabled) or 0(disabled)
start_date datetime Date the award is achievable from.
It will be null if a start date has not been specified. This means the award is achievable from the moment it was created on.
end_date datetime Date the award will stop being achievable.
It will be null if an end date has not been specified. This means the award will be achievable until it is deleted from the system.
score int Score necessary to achieve the award
level int Level the score must be reached in to achieve the award
image_filename string Name of the image that represents the award
created_on datetime Date the award was created
updated_on datetime Date the award was updated
url string The url it will take the user to when he clicks on the url
user_id integer The ID of the user
user_has_award boolean true if the user has achieved the award. false otherwise
dateawarded datetime Date the user achieved the award. null if the user hasn't achieved the award

Example

Request

https://api.miniclip.com/json/?app_id=##&secret=##&signature=##&method=Awards/User/List&access_token=##

Sample response

{
	"446":{
		"award_id":"446",
		"id":"446",
		"game_id":"2471",
		"title":"8 Ball Win",
		"description":"Win a game of 8 Ball Pool",
		"enabled":"1",
		"start_date":null,
		"end_date":null,
		"score":"0",
		"level":"0",
		"image_filename":"446",
		"created_on":"2014-01-01 10:30:01",
		"updated_on":"2014-01-01 10:30:01",
		"url":"http:\/\/www.miniclip.com\/games\/8-ball-pool-multiplayer\/en\/",
		"user_id":"437",
		"user_has_award":true
		"dateawarded":"2014-09-02 09:28:05",
	},
	...
}