Console
Achievements

List Achievements

Returns all achievements for an app. When authenticated with a user token, includes per-user unlock status; secret achievements locked by the user appear as ???.

POST /api/achievements/list.php
Authorization: AppID:AppKey or user session token

Request body

FieldTypeRequiredDescription
app_idstringrequiredApp package name to query

Success response 200

{
  "success": true,
  "app_id": "com.myapp.game",
  "count": 3,
  "achievements": [
    {
      "id": 1,
      "slug": "first_kill",
      "name": "First Kill",
      "description": "Get your first kill",
      "icon": "https://...",
      "rarity": "common",
      "xp": 100,
      "secret": false,
      "unlocked": true,
      "unlocked_at": "2026-05-29 15:00:00"
    },
    {
      "id": 2,
      "slug": "???",
      "name": "???",
      "description": "Secret achievement",
      "icon": "",
      "rarity": "legendary",
      "xp": 2000,
      "secret": true,
      "unlocked": false,
      "unlocked_at": null
    }
  ]
}
{
  "success": true,
  "app_id": "com.myapp.game",
  "count": 3,
  "achievements": [
    {
      "id": 1,
      "slug": "first_kill",
      "name": "First Kill",
      "description": "Get your first kill",
      "icon": "https://...",
      "rarity": "common",
      "xp": 100,
      "secret": false
    }
  ]
}

Note: When authenticated with AppID:AppKey, all achievements (including secret ones) are returned without unlock data. When authenticated with a user token, secret achievements the user hasn't unlocked show as ???.