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>"
  }
}
'
{
  "accountId": 1,
  "animatedAvatar": "<string>",
  "appCost": 1,
  "appPrivacy": "private",
  "apps": 1,
  "avatar": "<string>",
  "avatarFrame": "<string>",
  "awardsGiven": 1,
  "awardsReceived": 1,
  "background": "<string>",
  "badges": 1,
  "bans": 1,
  "communityBan": true,
  "connections": [
    {
      "avatar": "<string>",
      "connectionId": "<string>",
      "externalId": "<string>",
      "failed": true,
      "hide": true,
      "name": "<string>",
      "provider": "discord",
      "verified": true
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "currentBestRanks": [
    {
      "leaderboard": "apps",
      "ranks": "<string>"
    }
  ],
  "currentRanks": [
    {
      "leaderboard": "apps",
      "ranks": "<string>"
    }
  ],
  "donated": 1,
  "economyBan": "<string>",
  "foilBadgeCost": 1,
  "foilBadges": 1,
  "friendPrivacy": "private",
  "friends": 1,
  "gameBans": 1,
  "images": [
    {
      "active": true,
      "fileName": "<string>",
      "imageId": "<string>",
      "imageType": "avatar"
    }
  ],
  "lastBanDate": "2023-11-07T05:31:56Z",
  "lastQueueStatus": "undefined",
  "level": 1,
  "miniBackground": "<string>",
  "name": "<string>",
  "nextAllowedTime": "2023-11-07T05:31:56Z",
  "normalBadgeCost": 1,
  "normalBadges": 1,
  "playtime": 1,
  "pointsGiven": 1,
  "pointsReceived": 1,
  "privacy": "private",
  "roles": [
    {
      "extras": {},
      "rating": 123,
      "role": "user"
    }
  ],
  "shortlinkDomain": "<string>",
  "steamId": "<string>",
  "steamSetsScore": 1,
  "steamSetsVanity": "<string>",
  "steamVanity": "<string>",
  "theme": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "vacBans": 1,
  "xp": 1,
  "$schema": "<string>",
  "city": {
    "name": "<string>"
  },
  "country": {
    "name": "<string>",
    "code": "<string>"
  },
  "region": {
    "name": "<string>"
  },
  "state": {
    "name": "<string>"
  }
}
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<int32>
required

The account id

Required range: x >= 0
Example:

123456

​
animatedAvatar
string
required

The animated avatar of the account

Example:

"steamsets"

​
appCost
integer<int32>
required
deprecated

The cost of an app

Required range: x >= 0
Example:

123456

​
appPrivacy
enum<string>
required

The privacy of the account

Available options:
private,
public,
friends_only
Example:

"public"

​
apps
integer<int32>
required

The number of apps the account has

Required range: x >= 0
Example:

123456

​
avatar
string
required

The avatar hash of the account

Example:

"f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9"

​
avatarFrame
string
required

The avatar frame of the account

Example:

"steamsets"

​
awardsGiven
integer<int32>
required

The number of awards the account has

Required range: x >= 0
Example:

123456

​
awardsReceived
integer<int32>
required

The number of awards the account has

Required range: x >= 0
Example:

123456

​
background
string
required

The background of the account

Example:

"steamsets"

​
badges
integer<int32>
required

The number of badges the account has

Required range: x >= 0
Example:

123456

​
bans
integer<int32>
required

The number of bans

Required range: x >= 0
​
communityBan
boolean
required

If the account is community banned or not

Example:

false

​
connections
object[] | null
required

The connections of the account

​
createdAt
string<date-time> | null
required

The time the account was created

Example:

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

​
currentBestRanks
object[] | null
required

The current best ranks

​
currentRanks
object[] | null
required

The current ranks

​
donated
integer<int32>
required

The total of donations the account has

Required range: x >= 0
Example:

123456

​
economyBan
string
required

The economy ban of the account

Example:

"steam"

​
foilBadgeCost
integer<int32>
required
deprecated

The cost of a foil badge

Required range: x >= 0
Example:

123456

​
foilBadges
integer<int32>
required

The number of foil badges the account has

Required range: x >= 0
Example:

123456

​
friendPrivacy
enum<string>
required

The privacy of the account

Available options:
private,
public,
friends_only
Example:

"public"

​
friends
integer<int32>
required

The number of friends the account has

Required range: x >= 0
Example:

123456

​
gameBans
integer<int32>
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

Example:

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

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

The level of the account

Required range: x >= 0
Example:

123456

​
miniBackground
string
required

The mini background of the account

Example:

"steamsets"

​
name
string
required

The name of the account

Example:

"steamsets"

​
nextAllowedTime
string<date-time>
required

The time the account is allowed to be refreshed

​
normalBadgeCost
integer<int32>
required
deprecated

The cost of a normal badge

Required range: x >= 0
Example:

123456

​
normalBadges
integer<int32>
required

The number of normal badges the account has

Required range: x >= 0
Example:

123456

​
playtime
integer<int32>
required

The playtime of the account

Required range: x >= 0
Example:

123456

​
pointsGiven
integer<int32>
required

The number of points the account has

Required range: x >= 0
Example:

123456

​
pointsReceived
integer<int32>
required

The number of points the account has

Required range: x >= 0
Example:

123456

​
privacy
enum<string>
required

The privacy of the account

Available options:
private,
public,
friends_only
Example:

"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

Example:

"steamsets.link"

​
steamId
string
required

The steam id

Example:

"76561198842603734"

​
steamSetsScore
integer<int32>
required

The steam sets score

Required range: x >= 0
​
steamSetsVanity
string
required

The vanity of the account

Example:

"steamsets"

​
steamVanity
string
required

The vanity of the account

Example:

"steamsets"

​
theme
string
required

The theme of the account

Example:

"steamsets"

​
updatedAt
string<date-time> | null
required

The time the account was updated

Example:

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

​
vacBans
integer<int32>
required

The number of vac bans

Required range: x >= 0
​
xp
integer<int32>
required

The number of xp the account has

Required range: x >= 0
Example:

123456

​
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

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

​
city
object

The city of the account

​
country
object

The country of the account

​
region
object

The region of the account

​
state
object

The state of the account