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

# List account badges

`POST /v1/account.listBadges`

## Request body

- V1AccountListBadgesRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `filter` string[], nullable
  - `filters` V1BadgeFilters
    - `appIds` integer[], nullable — Filter to badges from these app IDs
    - `hasHighestLevel` boolean, nullable — If true, only badges where the user has reached the highest known level; if false, only badges where the user has not
    - `isEvent` boolean, nullable — Filter by event badges
    - `isFoil` boolean, nullable — Filter by foil badges
    - `isSale` boolean, nullable — Filter by sale badges
    - `level` Range
      - `max` integer — Maximum value (inclusive)
      - `min` integer — Minimum value (inclusive)
    - `scarcity` Range
      - `max` integer — Maximum value (inclusive)
      - `min` integer — Minimum value (inclusive)
    - `viewerLevel` Range
      - `max` integer — Maximum value (inclusive)
      - `min` integer — Minimum value (inclusive)
    - `viewerOwnership` 'owned' | 'missing', nullable — Compare against the authenticated caller: 'owned' keeps badges the caller also has, 'missing' keeps badges only the listed account has. Level-agnostic — the caller owns a badge if they hold it at any level. Requires authentication
  - `id` IDSearch
    - `accountId` integer — Account ID to search for
    - `steamId64` string — SteamID64 to search for
  - `order` V1BadgeOrder, nullable
    - `by` 'xp' | 'level' | 'scarcity' | 'name' | 'completion_time' | 'app_name' | 'app_id' | 'tracked_holders' | 'first_completion' | 'last_completion', required
    - `direction` 'asc' | 'desc', required
  - `page` integer, required
  - `search` string, nullable
  - `valueFilter` BadgeValueFilter[], nullable
    - `type` 'level' | 'scarcity', required
    - `value` string, required
  - `vanity` VanitySearch
    - `type` 'steam' | 'internal', required — Which type of vanity to search for
    - `value` string, required — Vanity to search for

## Response `200`

OK

- V1AccountListBadgesResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `badges` V1AppBadge[], nullable, required
    - `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
  - `pages` integer, required — The number of pages
  - `totalHits` integer, required — The total number of hits for all pages

## 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)