---
title: Your account
description: Read the badges, inventory and games of the account that owns your API key. These routes are free.
sidebar:
  icon: user
  order: 4
---

The `account.me` routes act on the SteamSets account that owns your API key. They take no account id, and they use no units of your daily allowance.

| Endpoint                       | Returns                                                                   |
| ------------------------------ | ------------------------------------------------------------------------- |
| `account.me.listBadges`        | Your crafted badges, one entry per app and badge type.                    |
| `account.me.listInventorySets` | The trading cards in your inventory, grouped by app, with craftable sets. |
| `account.me.refreshInventory`  | Queues a new read of your Steam inventory.                                |
| `account.me.listAppIds`        | The ids of the apps you own.                                              |

## Badges

`account.me.listBadges` returns one entry per app and badge type, with the highest level you crafted:

```json
{
  "badges": [
    {
      "appId": 730,
      "isFoil": false,
      "level": 5,
      "xp": 500,
      "completedAt": "2025-05-01T12:00:00Z",
      "badgeIds": ["bdg_1", "bdg_5"]
    }
  ],
  "badgesUpdatedAt": "2026-11-15T08:30:00Z",
  "nextCursor": null
}
```

- `badgeIds` holds the SteamSets id of every level you crafted. An event or sale app can have more than one badge per type.
- A page holds 5,000 badges by default and up to 20,000 with `limit`.
- Send `appIds` (up to 100) to get some apps only.
- The data is as fresh as `badgesUpdatedAt`.

## Inventory

`account.me.listInventorySets` returns the cards you hold, grouped by app. For each side, `cardCount` is the number of cards in one set, and `craftableSets` is the number of complete sets you can craft. A page holds 100 apps by default and up to 500.

The data is as fresh as `inventoryUpdatedAt`. To read your inventory again, call `account.me.refreshInventory`. It answers with `nextRefreshAt`. You can refresh once an hour, or more often on a supporter tier. A refresh before `nextRefreshAt` gets `429`.

## Owned apps

`account.me.listAppIds` returns the ids of the apps you own, and `appPrivacy`, the privacy of your game details on Steam. Steam lists owned games only when the game details are public. With any other `appPrivacy`, the list is empty or old.

A page holds 50,000 app ids by default and up to 100,000. The list is as old as your account's last refresh on SteamSets.

## Paging

All three list routes page the same way. Send `nextCursor` back as `cursor` for the next page. `nextCursor` is `null` on the last page.
