List your crafted badges
Returns the badges of your own account: one entry per app and badge type, with the highest level crafted.
badgeIds lists the SteamSets id of every crafted level of that badge. An event or sale app can have more than one badge per type.
Paging
A page holds 5,000 badges by default and up to 20,000. Send nextCursor back as cursor for the next page. Use appIds to ask for some apps only.
Freshness
The data is as fresh as badgesUpdatedAt.
Cost
This route is free. Your own data uses no units of the key’s daily allowance.
Example
{
"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
}
/v1/account.me.listBadgesAuthorizationBearer token · headerrequiredapplication/jsonappIdsinteger<int32>[] | nullOnly these apps. Leave it out for every app.
cursorstringThe nextCursor of the previous page. Leave it out for the first page.
limitinteger<int64>Badges per page.
OK
badgesAccountMeBadge[]requiredOne entry per app and badge type, by app id, normal before foil.
Show propertiesHide properties
AccountMeBadgeappIdinteger<int32>requiredbadgeIdsstring[]requiredThe SteamSets ids of every crafted level of this badge. An event or sale app can have more than one badge per type.
completedAtstring<date-time>requiredWhen the highest level was crafted.
isFoilbooleanrequiredlevelinteger<int32>requiredThe highest level crafted.
xpinteger<int32>requiredThe XP of the highest level crafted.
badgesUpdatedAtstring<date-time> | nullrequiredWhen SteamSets last read the account's badges from Steam. Null when it never has.
nextCursorstring | nullrequiredSend it as cursor for the next page. Null on the last page.
Bad Request
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Unauthorized
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Unprocessable Entity
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.
Internal Server Error
detailstringA human-readable explanation specific to this occurrence of the problem.
errorsErrorDetail[] | nullOptional list of individual error details
Show propertiesHide properties
ErrorDetaillocationstringWhere the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
messagestringError message text
valueanyThe value at the given location
instancestring<uri>A URI reference that identifies the specific occurrence of the problem.
statusinteger<int64>HTTP status code
titlestringA short, human-readable summary of the problem type. This value should not change between occurrences of the error.
typestring<uri>A URI reference to human-readable documentation for the error.