POST
/
v1
/
app.listBadges
List app badges
curl --request POST \
  --url https://api.steamsets.com/v1/app.listBadges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "appId": 1
}'
{
  "$schema": "https://api.steamsets.com/schemas/V1AppListBadgesResponseBody.json",
  "badges": [
    {
      "accountInfo": {
        "completionTime": "2023-01-01T00:00:00Z",
        "level": 123456,
        "xp": 123456
      },
      "appId": 1,
      "appImage": "<string>",
      "appName": "<string>",
      "badgeId": "<string>",
      "badgeImage": "<string>",
      "baseLevel": 1,
      "baseXp": 1,
      "firstCompletion": "2023-11-07T05:31:56Z",
      "highestLevel": 123,
      "isEvent": true,
      "isFoil": true,
      "isSale": true,
      "lastCompletion": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "price": 123,
      "scarcity": 1,
      "steamId": 1
    }
  ]
}
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.

Body

application/json
​
appId
integer
required

The ID of the app

Required range: x >= 0

Response

OK

​
badges
object[] | null
required

The available badges

​
$schema
string<uri>

A URL to the JSON Schema for this object.

Examples:

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