POST
/
v1
/
account.listBadges
List account badges
curl --request POST \
  --url https://api.steamsets.com/v1/account.listBadges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filter": [
    "foil"
  ],
  "filters": {
    "isEvent": true,
    "isFoil": true,
    "isSale": true,
    "level": {
      "max": 123,
      "min": 123
    },
    "scarcity": {
      "max": 123,
      "min": 123
    }
  },
  "id": {
    "accountId": 1,
    "steamId64": "<string>"
  },
  "order": {
    "by": "xp",
    "direction": "desc"
  },
  "page": 1,
  "search": "<string>",
  "valueFilter": [
    {
      "type": "level",
      "value": "<string>"
    }
  ],
  "vanity": {
    "type": "steam",
    "value": "<string>"
  }
}'
{
  "$schema": "https://api.steamsets.com/schemas/V1AccountListBadgesResponseBody.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
    }
  ],
  "pages": 1,
  "totalHits": 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

Response

OK

The response is of type object.