---
search:
  tags:
    - Apps
    - POST
seo:
  description: >-
    Returns the trading card badges of up to 100 apps, sale and event apps
    included. Reference for the POST /v1/app.get endpoint in the SteamSets API.
sidebar:
  label: Get the trading card badges of apps
  badge: POST
title: Get the trading card badges of apps
type: openapi-operation
---
Returns the trading card badges of up to 100 apps, sale and event apps included.

### What you get

- Every badge level with its id, image, XP, scarcity, tracked holders, the highest level crafted, and the first and latest craft SteamSets knows.
- For card badges, the cards and the card, set, badge and booster prices in US cents.
- A badge without prices, such as a sale or event tier, has no `prices`, `booster`, `isMarketable`, `isEveryCardListed` or `updatedAt`.

Ids that SteamSets does not know, or that have no badge, are in `missing`.

### Freshness

Prices are up to an hour behind steamsets.com, and badge data up to 30 minutes.

### Cost

Each app id uses one unit of the key's 5,000 daily units, found or not.

### Example

```json
{
  "apps": [
    {
      "appId": 730,
      "name": "Counter-Strike 2",
      "isSale": false,
      "isEvent": false,
      "normal": {
        "cardCount": 5,
        "isMarketable": true,
        "prices": { "setCents": 52, "toLevelCents": [52, 104, 157, 210] },
        "levels": [{ "badgeId": "bdg_4f2k", "steamBadgeId": 2, "level": 1, "xp": 100, "scarcity": 812345 }]
      }
    }
  ],
  "missing": [],
  "snapshotAt": "2026-11-16T10:00:00Z"
}
```

`POST /v1/app.get`

**Request body** (`application/json`, required)

- `appIds` (integer<int32>[], required) — Steam app ids, as in store.steampowered.com/app/\<appId\>. Each id uses one unit of the key's daily allowance, found or not.

Request body example:

```json
{
  "appIds": [
    730,
    753
  ]
}
```

**Responses**

- `200` — OK
- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

Response example, 200:

```json
{
  "apps": [
    {
      "appId": 0,
      "foil": {
        "booster": {
          "buyOrderCents": 0,
          "gems": 0,
          "priceCents": 0
        },
        "cardCount": 0,
        "cards": [
          {
            "buyOrderCents": 0,
            "copyPricesCents": [
              0
            ],
            "name": "string",
            "priceCents": 0
          }
        ],
        "isEveryCardListed": true,
        "isMarketable": true,
        "levels": [
          {
            "badgeId": "bdg_123",
            "firstCompletedAt": "2019-08-24T14:15:22Z",
            "highestLevel": 0,
            "image": "string",
            "lastCompletedAt": "2019-08-24T14:15:22Z",
            "level": 0,
            "name": "string",
            "scarcity": 0,
            "steamBadgeId": 0,
            "trackedHolders": 0,
            "xp": 0
          }
        ],
        "prices": {
          "cardAverageCents": 0,
          "cardBuyOrderAverageCents": 0,
          "fullBadgeCents": 0,
          "setBuyOrderCents": 0,
          "setCents": 0,
          "toLevelCents": [
            0
          ]
        },
        "updatedAt": "2019-08-24T14:15:22Z"
      },
      "image": "string",
      "isEvent": true,
      "isSale": true,
      "name": "string",
      "normal": {
        "booster": {
          "buyOrderCents": 0,
          "gems": 0,
          "priceCents": 0
        },
        "cardCount": 0,
        "cards": [
          {
            "buyOrderCents": 0,
            "copyPricesCents": [
              0
            ],
            "name": "string",
            "priceCents": 0
          }
        ],
        "isEveryCardListed": true,
        "isMarketable": true,
        "levels": [
          {
            "badgeId": "bdg_123",
            "firstCompletedAt": "2019-08-24T14:15:22Z",
            "highestLevel": 0,
            "image": "string",
            "lastCompletedAt": "2019-08-24T14:15:22Z",
            "level": 0,
            "name": "string",
            "scarcity": 0,
            "steamBadgeId": 0,
            "trackedHolders": 0,
            "xp": 0
          }
        ],
        "prices": {
          "cardAverageCents": 0,
          "cardBuyOrderAverageCents": 0,
          "fullBadgeCents": 0,
          "setBuyOrderCents": 0,
          "setCents": 0,
          "toLevelCents": [
            0
          ]
        },
        "updatedAt": "2019-08-24T14:15:22Z"
      }
    }
  ],
  "missing": [
    0
  ],
  "snapshotAt": "2019-08-24T14:15:22Z"
}
```
