Steam
Badges
Get Steam user badges including XP, level, and completion details.
Endpoint
This endpoint returns the badge data for a Steam user, including badge level, XP earned, and completion timestamps. This data was previously part of the v1 summary endpoint and is now available as a dedicated endpoint.
GET /v2/steam/users/{steamid}/badges
Required parameters
steamid
string
The Steam ID of the user whose badges you want to fetch. Accepts various Steam ID formats.
Authentication
Include your API key as the x-api-key request header.
x-api-key: YourSecretAPIKey
Response fields
| Field | Type | Description |
|---|---|---|
badges | array | Array of badge objects |
player_xp | number | Total XP earned by the player |
player_level | number | Current Steam level of the player |
player_xp_needed_to_level_up | number | XP needed to reach the next level |
player_xp_needed_current_level | number | XP required for the current level |
Badge object
| Field | Type | Description |
|---|---|---|
badgeid | number | The badge ID |
appid | number | Application ID (for game-specific badges, optional) |
level | number | Current level of the badge |
completion_time | number | Unix timestamp when the badge was earned or leveled |
xp | number | XP earned from this badge |
scarcity | number | Number of users who have this badge |
communityitemid | string | Community item ID (for game badges, optional) |
border_color | number | Border color value (for game badges, optional) |
Response example
Example output for this endpoint. For brevity's sake, some badges were omitted.
response.json
{
"success": true,
"result": {
"badges": [
{
"badgeid": 13,
"level": 625,
"completion_time": 1766289028,
"xp": 875,
"scarcity": 916315
},
{
"badgeid": 1,
"appid": 730,
"level": 5,
"completion_time": 1415375204,
"xp": 500,
"communityitemid": "1111254987",
"border_color": 0,
"scarcity": 9204132
}
],
"player_xp": 23450,
"player_level": 42,
"player_xp_needed_to_level_up": 50,
"player_xp_needed_current_level": 400
}
}