Skip to main content
POST
/
v1
/
leaderboard.listBadges
List leaderboard badges
curl --request POST \
  --url https://api.steamsets.com/v1/leaderboard.listBadges \
  --header 'Authorization: Bearer <token>'
{
  "$schema": "https://api.steamsets.com/schemas/V1LeaderboardListBadgesResponseBody.json",
  "badges": [
    {
      "appId": 730,
      "appImage": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/apps/730/a1a2f9f3f4c0c2b1f8d3a4e5f6d7e8f9.jpg",
      "appName": "Counter-Strike: Global Offensive",
      "badgeId": "bdg_123",
      "firstCompletion": "2023-01-01T00:00:00Z",
      "highestLevel": 123456,
      "image": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/items/2861690/088ef3b86f9529b031929eab0a2e60bf30d1b904.png",
      "isEvent": true,
      "isFoil": true,
      "isSale": true,
      "lastCompletion": "2023-01-01T00:00:00Z",
      "level": 123456,
      "name": "Sommer Sale 2024 Foil 1+",
      "price": 1200,
      "scarcity": 123456,
      "steamId": 76561198842603730,
      "xp": 123456
    }
  ]
}
This endpoint supports API key authentication for external integrations

API Access

This endpoint can be accessed using:
  • API Keys: For external applications and integrations
  • User Sessions: For web application access
See our API documentation for authentication details.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

OK

badges
object[] | null
required

The badges

$schema
string<uri>

A URL to the JSON Schema for this object.

Examples:

"https://api.steamsets.com/schemas/V1LeaderboardListBadgesResponseBody.json"