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

List the card sets in your inventory

Returns the trading cards in your own Steam inventory grouped by app, with the cards you hold of each set and the complete sets you can craft.

For each side, cardCount is the number of cards in one set, and craftableSets is 0 unless you hold every card of the set.

Paging

A page holds 100 apps by default and up to 500. Send nextCursor back as cursor for the next page.

Freshness

The data is as fresh as inventoryUpdatedAt. Call account.me.refreshInventory to read the inventory again, from nextRefreshAt on.

Cost

This route is free. Your own data uses no units of the key’s daily allowance.

Example

{
  "sets": [
    {
      "appId": 730,
      "normal": { "cards": [{ "name": "Phoenix", "owned": 2 }], "cardCount": 5, "craftableSets": 0 },
      "foil": { "cards": [], "cardCount": 5, "craftableSets": 0 }
    }
  ],
  "total": 1,
  "inventoryUpdatedAt": "2026-11-16T09:00:00Z",
  "nextRefreshAt": "2026-11-16T10:00:00Z",
  "nextCursor": null
}
POST/v1/account.me.listInventorySets
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
cursorstring

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

limitinteger<int64>

Apps per page.

min 1 · max 500 · default: 100
Responses
200

OK

inventoryUpdatedAtstring<date-time> | nullrequired

When SteamSets last read the inventory from Steam. Null when it never has.

nextCursorstring | nullrequired

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

nextRefreshAtstring<date-time> | nullrequired

The earliest time account.me.refreshInventory reads the inventory again. Null when it never has been read.

setsAccountMeInventorySet[]required

Apps with at least one card in the inventory, by app id.

Show properties
Array of AccountMeInventorySet
appIdinteger<int32>required
min 0
foilAccountMeInventorySiderequired
Show properties
cardCountinteger<int32>required

Cards in one set, 0 when SteamSets does not know the app's set.

min 0
cardsAccountMeInventoryCard[]required

The cards of this set in the inventory, by name. A card of the set that is not here is needed.

Show properties
Array of AccountMeInventoryCard
namestringrequired
ownedinteger<int32>required

Copies in the inventory.

min 0
craftableSetsinteger<int32>required

Complete sets the inventory holds: 0 unless it has every card of the set.

min 0
normalAccountMeInventorySiderequired
Show properties
cardCountinteger<int32>required

Cards in one set, 0 when SteamSets does not know the app's set.

min 0
cardsAccountMeInventoryCard[]required

The cards of this set in the inventory, by name. A card of the set that is not here is needed.

craftableSetsinteger<int32>required

Complete sets the inventory holds: 0 unless it has every card of the set.

min 0
totalinteger<int64>required

Apps across all pages.

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"
503

Service Unavailable

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.listInventorySets' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "cursor": "730",
  "limit": 100
}'
Response
{
  "inventoryUpdatedAt": "2019-08-24T14:15:22Z",
  "nextCursor": "string",
  "nextRefreshAt": "2019-08-24T14:15:22Z",
  "sets": [
    {
      "appId": 0,
      "foil": {
        "cardCount": 0,
        "cards": [
          {
            "name": "string",
            "owned": 0
          }
        ],
        "craftableSets": 0
      },
      "normal": {
        "cardCount": 0,
        "cards": [
          {
            "name": "string",
            "owned": 0
          }
        ],
        "craftableSets": 0
      }
    }
  ],
  "total": 0
}