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

# List owned badges

`POST /v1/account.listOwnedBadges`

## Query parameters

- `appId` integer — Only return badges of this app. Omit for all owned badges

## Response `200`

OK

- V1AccountBadgeOwnedBadgesResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `ownedBadges` V1AccountBadgeOwnedBadge[], nullable, required
    - `appId` integer, required — The app id
    - `badgeId` string, required — The badge id
    - `isFoil` boolean, required — Whether the badge is foil or not
    - `level` integer, required — The level of the badge
    - `steamId` integer, required — The internal steam id badge id

## 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/revisions/593d89718daa/schema)
