Get the trading card badges of apps
Returns the trading card badges of up to 100 apps, sale and event apps included.
What you get
- Every badge level with its id, image, XP, scarcity, tracked holders, the highest level crafted, and the first and latest craft SteamSets knows.
- For card badges, the cards and the card, set, badge and booster prices in US cents.
- A badge without prices, such as a sale or event tier, has no
prices,booster,isMarketable,isEveryCardListedorupdatedAt.
Ids that SteamSets does not know, or that have no badge, are in missing.
Freshness
Prices are up to an hour behind steamsets.com, and badge data up to 30 minutes.
Cost
Each app id uses one unit of the key’s 5,000 daily units, found or not.
Example
{
"apps": [
{
"appId": 730,
"name": "Counter-Strike 2",
"isSale": false,
"isEvent": false,
"normal": {
"cardCount": 5,
"isMarketable": true,
"prices": { "setCents": 52, "toLevelCents": [52, 104, 157, 210] },
"levels": [{ "badgeId": "bdg_4f2k", "steamBadgeId": 2, "level": 1, "xp": 100, "scarcity": 812345 }]
}
}
],
"missing": [],
"snapshotAt": "2026-11-16T10:00:00Z"
}
/v1/app.getAuthorizationBearer token · headerrequiredapplication/jsonappIdsinteger<int32>[]requiredSteam app ids, as in store.steampowered.com/app/<appId>. Each id uses one unit of the key's daily allowance, found or not.
OK
appsAppGetApp[]requiredThe requested apps that have a badge, in request order.
Show propertiesHide properties
AppGetAppappIdinteger<int32>requiredSteam app id.
foilAppGetBadgeMissing when the app has no foil badge.
Show propertiesHide properties
boosterAppGetBoosterBooster pack prices in US cents. Missing when the app has no booster pack or no prices.
Show propertiesHide properties
buyOrderCentsinteger<int32>requiredHighest booster pack buy order.
gemsinteger<int32>requiredGems to craft one booster pack.
priceCentsinteger<int32>requiredCheapest booster pack listing.
cardCountinteger<int32>requiredcardsAppGetCard[]requiredEmpty without prices.
Show propertiesHide properties
AppGetCardbuyOrderCentsinteger<int32>requiredHighest buy order.
copyPricesCentsinteger<int32>[]requiredcopyPricesCents[k-1] is the total price of k copies from the cheapest listings. Empty when not read yet.
namestringrequiredpriceCentsinteger<int32>requiredCheapest listing.
isEveryCardListedbooleanEvery card of this badge has a listing on the Steam market. Missing without prices.
isMarketablebooleanFalse when a card of this badge cannot be sold on the Steam market. Missing without prices.
levelsAppGetLevel[]requiredShow propertiesHide properties
AppGetLevelbadgeIdstringrequiredThe SteamSets id of this badge level.
firstCompletedAtstring<date-time>The first craft of this level that SteamSets knows. Missing when it knows none.
highestLevelinteger<int32>requiredThe highest level anyone SteamSets knows has crafted of this badge.
imagestringrequiredThe badge image of this level.
lastCompletedAtstring<date-time>The latest craft of this level that SteamSets knows. Missing when it knows none.
levelinteger<int32>requirednamestringrequiredscarcityinteger<int32>requiredHolders of this level, as Steam counts them.
steamBadgeIdinteger<int32>requiredSteam's id of the badge, 0 for a sale or event tier.
trackedHoldersinteger<int32>requiredHolders of this level that SteamSets has indexed.
xpinteger<int32>requiredpricesAppGetPricesPrices in US cents. Missing without prices.
Show propertiesHide properties
cardAverageCentsinteger<int32>requiredcardBuyOrderAverageCentsinteger<int32>requiredfullBadgeCentsinteger<int32>requiredEvery level of the badge from the cheapest listings, 0 when some card cannot be bought that many times.
setBuyOrderCentsinteger<int32>requiredOne of each card at the highest buy orders.
setCentsinteger<int32>requiredOne of each card from the cheapest listings.
toLevelCentsinteger<int32>[]requiredtoLevelCents[n-1] is the price of the first n levels, for n from 1 to 4. A foil badge has one level, so all four are the same.
updatedAtstring<date-time>When SteamSets last read these prices from the Steam market. Missing without prices.
imagestringrequiredThe app's capsule image.
isEventbooleanrequiredA Steam event's badge rather than a game's.
isSalebooleanrequiredA Steam sale's badge rather than a game's.
namestringrequirednormalAppGetBadgeMissing when the app has no normal badge. A sale or event app's tiers are here.
Show propertiesHide properties
boosterAppGetBoosterBooster pack prices in US cents. Missing when the app has no booster pack or no prices.
cardCountinteger<int32>requiredcardsAppGetCard[]requiredEmpty without prices.
isEveryCardListedbooleanEvery card of this badge has a listing on the Steam market. Missing without prices.
isMarketablebooleanFalse when a card of this badge cannot be sold on the Steam market. Missing without prices.
levelsAppGetLevel[]requiredpricesAppGetPricesPrices in US cents. Missing without prices.
updatedAtstring<date-time>When SteamSets last read these prices from the Steam market. Missing without prices.
missinginteger<int32>[]requiredThe requested apps that SteamSets does not know or that have no badge.
snapshotAtstring<date-time>requiredWhen the prices were copied for the API. They are up to an hour behind steamsets.com.
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.
Too Many Requests
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.
Service Unavailable
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.