---
search:
  tags:
    - Items
    - POST
seo:
  description: >-
    Returns trading items: cards, foils, booster packs, backgrounds and
    emoticons. Reference for the POST /v1/item.get endpoint in the SteamSets
    API.
sidebar:
  label: Get trading items by class id or app
  badge: POST
title: Get trading items by class id or app
type: openapi-operation
---
Returns trading items: cards, foils, booster packs, backgrounds and emoticons.

### Request

Send one of:

- `classIds`: up to 100 Steam class ids. Items come back in request order.
- `appIds`: up to 10 apps. Every item of each app comes back.

Ids that match no item are in `missing.classIds` or `missing.appIds`.

### Freshness

Items follow steamsets.com within about a minute.

### Cost

Each item returned and each id that matches nothing uses one unit of the key's 20,000 daily units.

### Example

```json
{
  "items": [
    {
      "classId": 667924416,
      "app": { "appId": 730, "name": "Counter-Strike 2" },
      "name": "Phoenix",
      "kind": "card",
      "isFoil": false,
      "isMarketable": true,
      "priceCents": 9
    }
  ],
  "missing": { "classIds": [], "appIds": [] }
}
```

`POST /v1/item.get`

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

- `appIds` (integer<int32>[] | null) — Steam app ids. Returns every item of each app: cards, foils, booster packs, backgrounds and emoticons. Send classIds or appIds, not both.
- `classIds` (integer<int64>[] | null) — Steam class ids, as in an inventory's classid. Send classIds or appIds, not both.

Request body example:

```json
{
  "appIds": [
    730
  ],
  "classIds": [
    667924416
  ]
}
```

**Responses**

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

Response example, 200:

```json
{
  "items": [
    {
      "app": {
        "appId": 0,
        "name": "string"
      },
      "classId": 0,
      "gems": 0,
      "isFoil": true,
      "isMarketable": true,
      "kind": "card",
      "lastSoldAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "points": 0,
      "priceCents": 0,
      "rarity": 0
    }
  ],
  "missing": {
    "appIds": [
      0
    ],
    "classIds": [
      0
    ]
  }
}
```
