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

# List app badges

`POST /v1/app.listBadges`

## Request body

- V1AppListBadgesRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `appId` integer, required — The ID of the app

## Response `200`

OK

- V1AppListBadgesResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `badges` V1AppBadge[], nullable, required — The available badges
    - `accountInfo` AccountBadgeInfo, nullable
      - `completionTime` string, date-time, required — The time the badge was completed
      - `level` integer, required — The level of the badge
      - `xp` integer, required — The xp of the badge
    - `appId` integer, required
    - `appImage` string, required
    - `appName` string, required
    - `badgeId` string, required
    - `badgeImage` string, required
    - `baseLevel` integer, required — The level this badge starts at
    - `baseXp` integer, required — The XP the badge gives per level
    - `cardCount` integer, required — Total trading cards Steam defines for this app (per side; foil and normal share the same count)
    - `firstCompletion` string, date-time, nullable, required
    - `highestLevel` integer, required
    - `isEvent` boolean, required
    - `isFoil` boolean, required
    - `isNmc` boolean, required — Whether the cards needed for this badge are non-marketable on Steam (cannot be bought/sold)
    - `isSale` boolean, required
    - `lastCompletion` string, date-time, nullable, required
    - `name` string, required
    - `noListing` boolean, required — Whether at least one card for this badge is not currently listed on the market
    - `price` integer, required
    - `scarcity` integer, required
    - `steamId` integer, required
    - `trackedHolders` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `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/593d89718daa/schema)