---
search:
  tags:
    - Groups
    - POST
seo:
  description: >-
    Returns Steam groups by id. Reference for the POST /v1/group.get endpoint in
    the SteamSets API.
sidebar:
  label: Get Steam groups by id
  badge: POST
title: Get Steam groups by id
type: openapi-operation
---
Returns Steam groups by id.

### Request

`groupIds` takes up to 100 Steam group ids. A group id is the low 32 bits of the group's SteamID64 (its gid).

### Response

Groups that SteamSets knows come back in request order with their name, vanity, tag, headline, avatar, member count, privacy, founding time and `isRemoved`. Ids that SteamSets does not know are in `missing`. The group owner is not included; look accounts up with `account.get`.

### Freshness

Groups follow steamsets.com within about a minute. A group's own data is as fresh as SteamSets' last read of its page.

### Cost

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

### Example

```json
{
  "groups": [
    {
      "groupId": 4,
      "name": "SteamSets",
      "vanity": "steamsets",
      "tag": "SSETS",
      "memberCount": 1520,
      "privacy": "public",
      "foundedAt": "2019-03-01T00:00:00Z",
      "isRemoved": false
    }
  ],
  "missing": []
}
```

`POST /v1/group.get`

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

- `groupIds` (integer<int32>[], required) — Steam group ids: the low 32 bits of the group's gid (SteamID64). Each id uses one unit of the key's daily allowance, found or not.

Request body example:

```json
{
  "groupIds": [
    4
  ]
}
```

**Responses**

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

Response example, 200:

```json
{
  "groups": [
    {
      "avatar": "string",
      "foundedAt": "2019-08-24T14:15:22Z",
      "groupId": 0,
      "headline": "string",
      "isRemoved": true,
      "memberCount": 0,
      "name": "string",
      "privacy": "public",
      "tag": "string",
      "vanity": "string"
    }
  ],
  "missing": [
    0
  ]
}
```
