Skip to content
SteamSets
Esc
↑↓navigate↵open⌘Jpreview
On this page

Your account

Read the badges, inventory and games of the account that owns your API key. These routes are free.

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:

{
  "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.