Skip to main content
POST
/
v1
/
account.getInfo
Get account profile information
curl --request POST \
  --url https://api.steamsets.com/v1/account.getInfo \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": {
    "accountId": 1,
    "steamId64": "<string>"
  },
  "vanity": {
    "type": "steam",
    "value": "<string>"
  }
}'
{
  "$schema": "https://api.steamsets.com/schemas/V1AccountGetInfoResponseBody.json",
  "accountId": 123456,
  "animatedAvatar": "steamsets",
  "appCost": 123456,
  "appPrivacy": "public",
  "apps": 123456,
  "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
  "avatarFrame": "steamsets",
  "awardsGiven": 123456,
  "awardsReceived": 123456,
  "background": "steamsets",
  "badges": 123456,
  "bans": 1,
  "city": {
    "name": "Bad Krozingen"
  },
  "communityBan": false,
  "connections": [
    {
      "avatar": "https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/avatars/f1/f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9.jpg",
      "connectionId": "123456",
      "externalId": "123456",
      "failed": true,
      "hide": true,
      "name": "steamsets",
      "provider": "discord",
      "verified": true
    }
  ],
  "country": {
    "code": "DE",
    "name": "Germany"
  },
  "createdAt": "2023-01-01T00:00:00Z",
  "currentBestRanks": [
    {
      "leaderboard": "apps",
      "ranks": "1,1,1,1,1"
    }
  ],
  "currentRanks": [
    {
      "leaderboard": "apps",
      "ranks": "1,1,1,1,1"
    }
  ],
  "donated": 123456,
  "economyBan": "steam",
  "foilBadgeCost": 123456,
  "foilBadges": 123456,
  "friendPrivacy": "public",
  "friends": 123456,
  "gameBans": 1,
  "images": [
    {
      "active": true,
      "fileName": "avatar.png",
      "imageId": "img_wasd123",
      "imageType": "avatar"
    }
  ],
  "lastBanDate": "2024-03-07 07:31:46",
  "lastQueueStatus": "undefined",
  "level": 123456,
  "miniBackground": "steamsets",
  "name": "steamsets",
  "nextAllowedTime": "2023-11-07T05:31:56Z",
  "normalBadgeCost": 123456,
  "normalBadges": 123456,
  "playtime": 123456,
  "pointsGiven": 123456,
  "pointsReceived": 123456,
  "privacy": "public",
  "region": {
    "name": "Europe"
  },
  "roles": [
    {
      "extras": {},
      "rating": 123,
      "role": "user"
    }
  ],
  "shortlinkDomain": "steamsets.link",
  "state": {
    "name": "Baden-Wurttemberg"
  },
  "steamId": "76561198842603734",
  "steamSetsScore": 1,
  "steamSetsVanity": "steamsets",
  "steamVanity": "steamsets",
  "theme": "steamsets",
  "updatedAt": "2023-01-01T00:00:00Z",
  "vacBans": 1,
  "xp": 123456
}
This endpoint supports API key authentication for external integrations

​
API Access

This endpoint can be accessed using:
  • API Keys: For external applications and integrations
  • User Sessions: For web application access
See our API documentation for authentication details.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
id
object
​
vanity
object

Response

OK

​
accountId
integer
required

The account id

Required range: x >= 0
Examples:

123456

​
animatedAvatar
string
required

The animated avatar of the account

Examples:

"steamsets"

​
appCost
integer
required
deprecated

The cost of an app

Required range: x >= 0
Examples:

123456

​
appPrivacy
enum<string>
required

The privacy of the account

Available options:
private,
public,
friends_only
Examples:

"public"

​
apps
integer
required

The number of apps the account has

Required range: x >= 0
Examples:

123456

​
avatar
string
required

The avatar hash of the account

Examples:

"f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9"

​
avatarFrame
string
required

The avatar frame of the account

Examples:

"steamsets"

​
awardsGiven
integer
required

The number of awards the account has

Required range: x >= 0
Examples:

123456

​
awardsReceived
integer
required

The number of awards the account has

Required range: x >= 0
Examples:

123456

​
background
string
required

The background of the account

Examples:

"steamsets"

​
badges
integer
required

The number of badges the account has

Required range: x >= 0
Examples:

123456

​
bans
integer
required

The number of bans

Required range: x >= 0
​
communityBan
boolean
required

If the account is community banned or not

Examples:

false

​
connections
object[] | null
required

The connections of the account

​
createdAt
string<date-time> | null
required

The time the account was created

Examples:

"2023-01-01T00:00:00Z"

​
currentBestRanks
object[] | null
required

The current best ranks

​
currentRanks
object[] | null
required

The current ranks

​
donated
integer
required

The total of donations the account has

Required range: x >= 0
Examples:

123456

​
economyBan
string
required

The economy ban of the account

Examples:

"steam"

​
foilBadgeCost
integer
required
deprecated

The cost of a foil badge

Required range: x >= 0
Examples:

123456

​
foilBadges
integer
required

The number of foil badges the account has

Required range: x >= 0
Examples:

123456

​
friendPrivacy
enum<string>
required

The privacy of the account

Available options:
private,
public,
friends_only
Examples:

"public"

​
friends
integer
required

The number of friends the account has

Required range: x >= 0
Examples:

123456

​
gameBans
integer
required

The number of game bans

Required range: x >= 0
​
images
object[] | null
required

The images of the account

​
lastBanDate
string<date-time> | null
required

The Last date the account got a ban on

Examples:

"2024-03-07 07:31:46"

​
lastQueueStatus
enum<string>
required
Available options:
undefined,
pending,
in_progress,
completed
​
level
integer
required

The level of the account

Required range: x >= 0
Examples:

123456

​
miniBackground
string
required

The mini background of the account

Examples:

"steamsets"

​
name
string
required

The name of the account

Examples:

"steamsets"

​
nextAllowedTime
string<date-time>
required

The time the account is allowed to be refreshed

​
normalBadgeCost
integer
required
deprecated

The cost of a normal badge

Required range: x >= 0
Examples:

123456

​
normalBadges
integer
required

The number of normal badges the account has

Required range: x >= 0
Examples:

123456

​
playtime
integer
required

The playtime of the account

Required range: x >= 0
Examples:

123456

​
pointsGiven
integer
required

The number of points the account has

Required range: x >= 0
Examples:

123456

​
pointsReceived
integer
required

The number of points the account has

Required range: x >= 0
Examples:

123456

​
privacy
enum<string>
required

The privacy of the account

Available options:
private,
public,
friends_only
Examples:

"public"

​
roles
object[] | null
required

The roles of the account

​
shortlinkDomain
string | null
required

The shortlink domain of the account, is to be used with their steamsets vanity

Examples:

"steamsets.link"

​
steamId
string
required

The steam id

Examples:

"76561198842603734"

​
steamSetsScore
integer
required

The steam sets score

Required range: x >= 0
​
steamSetsVanity
string
required

The vanity of the account

Examples:

"steamsets"

​
steamVanity
string
required

The vanity of the account

Examples:

"steamsets"

​
theme
string
required

The theme of the account

Examples:

"steamsets"

​
updatedAt
string<date-time> | null
required

The time the account was updated

Examples:

"2023-01-01T00:00:00Z"

​
vacBans
integer
required

The number of vac bans

Required range: x >= 0
​
xp
integer
required

The number of xp the account has

Required range: x >= 0
Examples:

123456

​
$schema
string<uri>

A URL to the JSON Schema for this object.

Examples:

"https://api.steamsets.com/schemas/V1AccountGetInfoResponseBody.json"

​
city
object | null

The city of the account

​
country
object | null

The country of the account

​
region
object | null

The region of the account

​
state
object | null

The state of the account