---
title: "Use when checking several players at once. Up to 100 Steam profiles in one request (comma-separated ids in any SteamID format except vanity names). When checking many players, prefer one batch call over per-player requests"
method: GET
path: "/batch/{ids}"
---

# Use when checking several players at once. Up to 100 Steam profiles in one request (comma-separated ids in any SteamID format except vanity names). When checking many players, prefer one batch call over per-player requests

`GET /batch/{ids}`

## Request

- Base URL: `https://steamgpt.net`
- URL: `https://steamgpt.net/batch/{ids}`
- Auth: one of:
  - none
  - OAuth 2 (client credentials, token URL `https://steamgpt.net/oauth/token`, scopes: `rate-boost`)

## Path parameters

- `ids` string, required

## Query parameters

- `include` string

## Response `200`

players + not_found + invalid lists

- Batch
  - `result` 'success'
  - `data` object
    - `count` integer
    - `players` object[]
      - `steamid64` string
      - `ids` Ids: All SteamID representations of the player
        - `steamid64` string
        - `steamid` string, nullable
        - `steamid3` string, nullable
      - `steam` SteamPlayer, nullable: Raw Steam GetPlayerSummaries player object, unmodified field names
        - `steamid` string
        - `personaname` string
        - `profileurl` string
        - `avatar` string
        - `avatarmedium` string
        - `avatarfull` string
        - `personastate` integer: 0 offline, 1 online, 2 busy, 3 away, 4 snooze, 5 looking to trade, 6 looking to play
        - `communityvisibilitystate` integer: 3 = public
        - `timecreated` integer: unixtime
        - `lastlogoff` integer: unixtime
        - `gameextrainfo` string
        - `loccountrycode` string
      - `faceit` object, nullable
      - `faceit_bans` object[]
      - `steam_bans` object, nullable
    - `not_found` string[]: valid steamid64 not found in cache
    - `invalid` string[]: inputs that are not steamid64 (sanitized echo)

## Other responses

- `400`: More than 100 ids
- `404`: Not found
- `429`: Rate limited, honor Retry-After

---

[API](https://skmtc.dev/steamgpt/apis/steamgpt-api.md) · [All operations](https://skmtc.dev/steamgpt/apis/steamgpt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/steamgpt/apis/steamgpt-api/revisions/e104f6425018?raw)