Skip to content

Game Achievement IDs

A call to this endpoint will retrieve the list of achievement IDs for a game, targeted by game ID. This can be useful if you'd like to quickly check how many achievements a particular game has. Using this, you can also detect if a game has received a revision. For example, if a game had 100 achievements last month and has 102 today, you know the game's achievement set has been revised.

On-site Representation

When browsing a game page, for example, Sonic the Hedgehog, each achievement on the list has a unique ID.

Achievement IDs

HTTP Request

GET

https://retroachievements.org/API/API_GetAchievementCount.php?i=14402

Query Parameters

NameRequired?Description
yYesYour web API key.
iYesThe target game ID.

Client Library

ts
import {
  buildAuthorization,
  getAchievementCount,
} from "@retroachievements/api";

// First, build your authorization object.
const username = "<your username on RA>";
const webApiKey = "<your web API key>";

const authorization = buildAuthorization({ username, webApiKey });

// Then, make the API call.
const achievementCount = await getAchievementCount(authorization, {
  gameId: 14402,
});
kotlin
val credentials = RetroCredentials("<username>", "<web api key>")
val api: RetroInterface = RetroClient(credentials).api

val response: NetworkResponse<GetAchievementCount.Response, ErrorResponse> = api.getAchievementCount(
    gameId = 14402
)

if (response is NetworkResponse.Success) {
    // handle the data
    val achievementCount: GetAchievementCount.Response = response.body

} else if (response is NetworkResponse.Error) {
    // if the server returns an error it be found here
    val errorResponse: ErrorResponse? = response.body

    // if the api (locally) had an internal error, it'll be found here
    val internalError: Throwable? = response.error
}

Response

json
{
  "GameID": 14402,
  "AchievementIDs": [
    79434, 79435, 79436, 79437, 79438, 79439, 79440, 79441, 79442, 79443, 79444,
    79445, 325413, 325414, 325415
  ]
}
json
{
  "gameId": 14402,
  "achievementIds": [
    79434, 79435, 79436, 79437, 79438, 79439, 79440, 79441, 79442, 79443, 79444,
    79445, 325413, 325414, 325415
  ]
}

Source

RepoURL
RAWebhttps://github.com/RetroAchievements/RAWeb/blob/master/public/API/API_GetAchievementCount.php
api-jshttps://github.com/RetroAchievements/api-js/blob/main/src/game/getAchievementCount.ts
api-kotlinhttps://github.com/RetroAchievements/api-kotlin/blob/main/src/main/kotlin/org/retroachivements/api/RetroInterface.kt

Released under the MIT license.