Check Achievement | Achievements API Reference

POST /api/achievements/check.php

Authorization: AppID:AppKey or user session token

Identify the achievement (one of)

Field	Type	Description
slug	string	Achievement slug — also requires `app_id` in the body
achievement_id	int	Numeric achievement ID

Identify the user (when auth is AppID:AppKey — one of)

Field	Type	Description
user_id	int	Numeric user ID
userkey	string	User's `userKey`
token	string	User's session token

When authenticated with a user token in the header, checks the authenticated user automatically.

Test this endpoint

Headers

Authorization *

Body

slug

app_id

token (or user_id)

Success response 200

{
  "success": true,
  "has": true,
  "unlocked_at": "2026-05-29 14:30:00",
  "achievement": {
    "id": 1,
    "slug": "first_kill",
    "name": "First Kill",
    "rarity": "common",
    "xp": 100
  },
  "user_id": 42
}

{
  "success": true,
  "has": false,
  "unlocked_at": null,
  "achievement": { "id": 1, "slug": "first_kill", ... },
  "user_id": 42
}