Retrieves a list of the configured achievements in the game, along with whether the current player has earned the achievement.

View interactive version here

Request Parameters

Parameter Required Type Description

Response Parameters

A reponse containing the game's achievments and an indication of whether the player has earned it

Parameter Type Description
achievements Achievement[] A list of JSON achievment objects
scriptData ScriptData A JSON Map of any data added either to the Request or the Response by your Cloud Code

Nested types


A nested object that represents the achievement data.

Parameter Type Description
description string The desciption of the Achievement
earned boolean Whether to current player has earned the achievement
name string The name of the Achievement
propertySet JSON The custom property set configured on this Achievement
shortCode string The shortCode of the Achievement


A collection of arbitrary data that can be added to a message via a Cloud Code script.

Parameter Type Description
myKey string An arbitrary data key
myValue JSON An arbitrary data value.

Code Samples


    using GameSparks.Api;
    using GameSparks.Api.Requests;
    using GameSparks.Api.Responses;
    new ListAchievementsRequest()
        .Send((response) => {
        GSEnumerable<ListAchievementsResponse._Achievement> achievements = response.Achievements;
        GSData scriptData = response.ScriptData;

ActionScript 3

    import com.gamesparks.*;
    import com.gamesparks.api.requests.*;
    import com.gamesparks.api.responses.*;
    import com.gamesparks.api.types.*;

        .send(function(response:com.gamesparks.api.responses.ListAchievementsResponse):void {
        var achievements:Vector.<Achievement> = response.getAchievements(); 
        var scriptData:ScriptData = response.getScriptData(); 


    #import "GS.h"
    #import "GSAPI.h"
    GSListAchievementsRequest* request = [[GSListAchievementsRequest alloc] init];
    [request setCallback:^ (GSListAchievementsResponse* response) {
    NSArray* achievements = [response getAchievements]; 
    NSDictionary* scriptData = [response getScriptData]; 
    [gs send:request];


    #include <GameSparks/generated/GSRequests.h>
    using namespace GameSparks::Core;
    using namespace GameSparks::Api::Responses;
    using namespace GameSparks::Api::Requests;

    void ListAchievementsRequest_Response(GS& gsInstance, const ListAchievementsResponse& response) {
    gsstl:vector<Types::Achievement*> achievements = response.getAchievements(); 
    GSData scriptData = response.getScriptData(); 

    ListAchievementsRequest request(gsInstance);


import com.gamesparks.sdk.api.autogen.GSRequestBuilder.ListAchievementsRequest;
import com.gamesparks.sdk.api.autogen.GSResponseBuilder.ListAchievementsResponse;
import com.gamesparks.sdk.api.autogen.GSTypes.*;
import com.gamesparks.sdk.api.GSEventListener;

    .send(new GSEventListener<ListAchievementsResponse>() {
        public void onEvent(ListAchievementsResponse response) {
            List<Achievement> achievements = response.getAchievements(); 

Cloud Code

    var request = new SparkRequests.ListAchievementsRequest();
    var response = request.Send();

var achievements = response.achievements; 
var scriptData = response.scriptData;