Steam
Achievements
Get a Steam user's achievements for a specific game, including unlock state and timestamp.
Endpoint
This endpoint returns the list of achievements for a specific game on a Steam user's account, with the current unlock state and unlock timestamp for each achievement.
GET /v2/steam/users/{steamid}/achievements/{appid}
Required parameters
steamid
string
The Steam ID of the user whose achievements you want to fetch. Accepts various Steam ID formats.
appid
number
The Steam application ID of the game whose achievements you want to fetch.
Authentication
Include your API key as the x-api-key request header.
x-api-key: YourSecretAPIKey
Response fields
| Field | Type | Description |
|---|---|---|
steamID | string | The user's SteamID64. |
game | string | The name of the game. |
achievements | array | List of achievement objects for this game. See fields below. |
Achievement object
| Field | Type | Description |
|---|---|---|
name | string | The internal identifier of the achievement. |
unlocked | boolean | Whether the user has unlocked this achievement. |
unlockedTimestamp | number | Unix timestamp of when the achievement was unlocked. 0 if the achievement is locked. |
Response example
Example output for this endpoint. For brevity's sake, most achievements were omitted.
response.json
{
"success": true,
"result": {
"steamID": "76561198038526790",
"game": "Rust",
"achievements": [
{
"name": "COLLECT_100_WOOD",
"unlocked": true,
"unlockedTimestamp": 1666118306
},
{
"name": "COLLECT_200_STONE",
"unlocked": true,
"unlockedTimestamp": 1666119743
},
{
"name": "CRAFT_CAMPFIRE",
"unlocked": false,
"unlockedTimestamp": 0
}
]
}
}