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
}
badgeIdsholds 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.