---
title: "Get account badge statistics"
method: POST
path: "/v1/account.getBadgeStats"
tags: ["account"]
---

# Get account badge statistics

`POST /v1/account.getBadgeStats`

## Request body

- AccountSearch
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `id` IDSearch
    - `accountId` integer — Account ID to search for
    - `steamId64` string — SteamID64 to search for
  - `vanity` VanitySearch
    - `type` 'steam' | 'internal', required — Which type of vanity to search for
    - `value` string, required — Vanity to search for

## Response `200`

OK

- V1AccountBadgeStats
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `count` V1AccountBadgeCountStats, required
    - `foil` integer, required
    - `normal` integer, required
    - `special` integer, required
  - `levels` object, required
  - `scarcities` object, required
  - `totalBadges` integer, required — The total number of badges
  - `xp` V1AccountBadgeXpStats, required
    - `foil` integer, required
    - `normal` 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/2e8ba266b27f/schema)