---
search:
  tags:
    - Accounts
    - POST
seo:
  description: >-
    Returns up to 100 Steam accounts that SteamSets already tracks, with level,
    badge… Reference for the POST /v1/account.get endpoint in the SteamSets API.
sidebar:
  label: Get Steam accounts
  badge: POST
title: Get Steam accounts
type: openapi-operation
---
Returns up to 100 Steam accounts that SteamSets already tracks, with level, badge counts and global leaderboard ranks.

### Request

Each entry in `accounts` can be:

- an account id, such as `882338006`
- a SteamID64, such as `76561198842603734`
- a SteamSets or Steam vanity, such as `steamsets`; a SteamSets vanity matches first
- a `steamcommunity.com/profiles/<steamId64>` or `steamcommunity.com/id/<vanity>` URL

### Missing accounts

This route never asks Steam. An account SteamSets has not seen, an account SteamSets hides, and an entry it cannot read are all in `missing`, as sent.

### Freshness

Profile data is as fresh as the account's last refresh. Ranks are live.

### Cost

Each entry uses one unit of the key's 10,000 daily units, found or not.

### Example

```json
{
  "accounts": [
    {
      "input": "steamsets",
      "account": {
        "accountId": 882338006,
        "steamId64": "76561198842603734",
        "name": "steamsets",
        "level": 120,
        "ranks": { "xp": { "rank": 1532, "score": 812345, "total": 2900000 } }
      }
    }
  ],
  "missing": []
}
```

`POST /v1/account.get`

**Request body** (`application/json`, required)

- `accounts` (string[], required) — Each entry is an account id, a SteamID64, a SteamSets or Steam vanity, or a steamcommunity.com/profiles/\<steamId64\> or steamcommunity.com/id/\<vanity\> URL. A bare vanity matches a SteamSets vanity first. Each entry uses one unit of the key's daily allowance, found or not.

Request body example:

```json
{
  "accounts": [
    "76561198842603734",
    "882338006",
    "steamsets",
    "https://steamcommunity.com/id/gabelogannewell"
  ]
}
```

**Responses**

- `200` — OK
- `400` — Bad Request
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

Response example, 200:

```json
{
  "accounts": [
    {
      "account": {
        "accountId": 882338006,
        "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
        "badges": {
          "foil": 0,
          "normal": 0,
          "total": 0
        },
        "level": 0,
        "name": "steamsets",
        "ranks": {
          "apps": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "awardsGiven": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "awardsReceived": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "badges": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "bans": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "foilBadges": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "gameBans": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "normalBadges": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "playtime": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "pointsGiven": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "pointsReceived": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "steamSets": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "vacBans": {
            "rank": 0,
            "score": 0,
            "total": 0
          },
          "xp": {
            "rank": 0,
            "score": 0,
            "total": 0
          }
        },
        "steamId64": "76561198842603734",
        "vanity": {
          "steam": "string",
          "steamSets": "string"
        },
        "xp": 0
      },
      "input": "string"
    }
  ],
  "missing": [
    "string"
  ]
}
```
