---
title: "List leaderboard badges"
method: POST
path: "/v1/leaderboard.listBadges"
tags: ["leaderboard"]
---

# List leaderboard badges

`POST /v1/leaderboard.listBadges`

## Response `200`

OK

- V1LeaderboardListBadgesResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `badges` V1LeaderboardBadge[], nullable, required — The badges
    - `appId` integer, required — The app id
    - `appImage` string, required — The image of the app
    - `appName` string, required — The name of the app
    - `badgeId` string, required — The public id of the badge
    - `firstCompletion` string, date-time, nullable, required — The time the badge was completed
    - `highestLevel` integer, nullable, required — The level the badge was completed
    - `image` string, required — The image of the badge
    - `isEvent` boolean, required — Whether the badge is an event or not
    - `isFoil` boolean, required — Whether the badge is foil or not
    - `isSale` boolean, required — Whether the badge is a sale or not
    - `lastCompletion` string, date-time, nullable, required — The time the badge was completed
    - `level` integer, required — The level of the badge
    - `name` string, required — The name of the badge
    - `price` integer, required — The price of the badge
    - `scarcity` integer, nullable, required — The scarcity of the badge
    - `steamId` integer, required — The steam id
    - `trackedHolders` integer, nullable, required — The number of holders steamsets tracks for the badge
    - `xp` integer, required — The xp of the badge

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/versions/f7c45c9ec36a/schema)