---
title: "Use when asked whether an account has VAC, game, community or economy bans. Steam ban status exactly as Steam returns it"
method: GET
path: "/bans/{id}"
---

# Use when asked whether an account has VAC, game, community or economy bans. Steam ban status exactly as Steam returns it

`GET /bans/{id}`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

GetPlayerBans object

- Bans
  - `result` 'success'
  - `data` object
    - `steamid64` string
    - `bans` object: Raw Steam GetPlayerBans object
      - `SteamId` string
      - `CommunityBanned` boolean
      - `VACBanned` boolean
      - `NumberOfVACBans` integer
      - `DaysSinceLastBan` integer
      - `NumberOfGameBans` integer
      - `EconomyBan` string
    - `provenance` object
      - `steam_bans` SourceProvenance
        - `source` string
        - `retrieved_at` integer, nullable: unixtime of the cached snapshot
        - `age_seconds` integer, nullable: snapshot age at response time
        - `fresh` boolean: age within cache_ttl; false when unknown
        - `cache_ttl` integer, nullable: refresh policy in seconds
        - `refreshed_with` string: steam_bans only: bans refresh together with this source snapshot

## Other responses

- `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)