Skip to content

API Reference / Steam account groups

Fetch multiple account groups by ID

Returns the account groups matching the given IDs within a workspace, alongside the IDs that did not resolve. Soft-deleted account groups are treated as not found.

POST/contracts.v1.Contracts/GetAccountGroups

Request body

application/jsonRequired

Request for several account groups in the caller's workspace by identifier, in one call.

accountGroupIds?array<string>

Account group identifiers to fetch.

Response body

application/json

Success

accountGroups?array<AccountGroup>

The account groups that were found.

Show attributes
createdAt?string

When the account group was created.

Format"date-time"

deletedAt?string

When the account group was soft-deleted, if it has been.

Format"date-time"

id?string

Opaque 16-byte account group identifier, base64-encoded in JSON.

Format"byte" base64

members?array<string>

Steam account names that belong to the group.

name?string

Human-readable account group name.

updatedAt?string

When the account group was last modified.

Format"date-time"

workspaceId?string

Workspace the account group belongs to.

Format"byte" base64

notFoundIds?array<string>

Requested IDs that did not resolve to an account group.

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetAccountGroups" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountGroupIds": [
      "EBESExQVFhcYGRobHB0eHw==",
      "ICEiIyQlJicoKSorLC0uLw=="
    ]
  }'
{
  "accountGroups": [
    {
      "id": "EBESExQVFhcYGRobHB0eHw==",
      "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
      "name": "AK-47 Redline buyers",
      "members": [
        "redline_trader_eu",
        "redline_trader_us",
        "float_hunter_01"
      ],
      "createdAt": "2026-03-12T08:30:00Z",
      "updatedAt": "2026-05-20T14:45:00Z"
    }
  ],
  "notFoundIds": [
    "ICEiIyQlJicoKSorLC0uLw=="
  ]
}