---
search:
  tags:
    - Apps
    - POST
seo:
  description: >-
    Returns the id, name and card count of every app with a trading card badge,
    by app id. Reference for the POST /v1/app.list endpoint in the SteamSets
    API.
sidebar:
  label: List every app with trading cards
  badge: POST
title: List every app with trading cards
type: openapi-operation
---
Returns the id, name and card count of every app with a trading card badge, by app id.

### Paging

A page holds 5,000 apps by default and up to 20,000. Send `nextCursor` back as `cursor` for the next page. It is null on the last page.

### Freshness

The list is up to an hour behind steamsets.com.

### Cost

This route is free. It uses no units of the key's daily allowance.

### Example

```json
{
  "apps": [
    { "appId": 220, "name": "Half-Life 2", "cardCount": 8, "hasNormal": true, "hasFoil": true }
  ],
  "nextCursor": "220"
}
```

`POST /v1/app.list`

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

- `cursor` (string) — The nextCursor of the previous page. Leave it out for the first page.
- `limit` (integer<int64>) — Apps per page.

Request body example:

```json
{
  "cursor": "730",
  "limit": 5000
}
```

**Responses**

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

Response example, 200:

```json
{
  "apps": [
    {
      "appId": 0,
      "cardCount": 0,
      "hasFoil": true,
      "hasNormal": true,
      "name": "string"
    }
  ],
  "nextCursor": "string"
}
```
