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

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
}
POST/v1/account.me.listBadges
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
appIdsinteger<int32>[] | null

Only these apps. Leave it out for every app.

max items 100
cursorstring

The nextCursor of the previous page. Leave it out for the first page.

limitinteger<int64>

Badges per page.

min 1 · max 20000 · default: 5000
Responses
200

OK

badgesAccountMeBadge[]required

One entry per app and badge type, by app id, normal before foil.

Show properties
Array of AccountMeBadge
appIdinteger<int32>required
min 0
badgeIdsstring[]required

The 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>required

When the highest level was crafted.

isFoilbooleanrequired
levelinteger<int32>required

The highest level crafted.

min 0
xpinteger<int32>required

The XP of the highest level crafted.

min 0
badgesUpdatedAtstring<date-time> | nullrequired

When SteamSets last read the account's badges from Steam. Null when it never has.

nextCursorstring | nullrequired

Send it as cursor for the next page. Null on the last page.

400

Bad Request

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties
Array of ErrorDetail
locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A 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.

default: "about:blank"
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST 'https://api.steamsets.com/v1/account.me.listBadges' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "appIds": [
    730
  ],
  "cursor": "730_normal",
  "limit": 5000
}'
Response
{
  "badges": [
    {
      "appId": 0,
      "badgeIds": [
        "bdg_123"
      ],
      "completedAt": "2019-08-24T14:15:22Z",
      "isFoil": true,
      "level": 0,
      "xp": 0
    }
  ],
  "badgesUpdatedAt": "2019-08-24T14:15:22Z",
  "nextCursor": "string"
}