Skip to content

All Recent Game Awards

A call to this endpoint will retrieve all recently granted game awards across the site's userbase.

On-site Representation

This data can be found on the Recent Game Awards page, for example:

Recent Game Awards

HTTP Request

GET

https://retroachievements.org/API/API_GetRecentGameAwards.php

Query Parameters

NameRequired?Description
zYesYour username.
yYesYour web API key.
dStarting date (YYYY-MM-DD) (default: now).
oOffset, number of entries to skip (default: 0).
cCount, number of entries to return (default: 25, maximum: 100).
kA comma-separated list of desired game award kinds. Possible values are "beaten-softcore", "beaten-hardcore", "completed", and "mastered" (default: all game award kinds).

Client Library

ts
import {
  buildAuthorization,
  getRecentGameAwards,
} 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 game = await getRecentGameAwards(authorization);

Response

json
{
  "Count": 25,
  "Total": 172318,
  "Results": [
    {
      "User": "renanbrj",
      "AwardKind": "mastered",
      "AwardDate": "2022-01-01T23:48:04+00:00",
      "GameID": 14284,
      "GameTitle": "Batman Returns",
      "ConsoleID": 15,
      "ConsoleName": "Game Gear"
    }
    // ...
  ]
}
json
{
  "count": 25,
  "total": 452857,
  "results": [
    {
      "user": "renanbrj",
      "awardKind": "mastered",
      "awardDate": "2022-01-01T23:48:04+00:00",
      "gameId": 14_284,
      "gameTitle": "Batman Returns",
      "consoleId": 15,
      "consoleName": "Game Gear"
    }
    // ...
  ]
}

Source

RepoURL
RAWebhttps://github.com/RetroAchievements/RAWeb/blob/master/public/API/API_GetRecentGameAwards.php
api-jshttps://github.com/RetroAchievements/api-js/blob/main/src/feed/getRecentGameAwards.ts

Released under the MIT license.