Sign in
admin

List new and active users

Changed on
post/v1/admin.listUsers

Request

  • Base URL: https://api.steamsets.com
  • URL: https://api.steamsets.com/v1/admin.listUsers
  • Auth: HTTP bearer

Request body

$schemastring uri

A URL to the JSON Schema for this object.

direction'asc' | 'desc' required

The order direction

limitinteger required

Rows per page

orderBy'signedUp' | 'lastSeen' | 'level' | 'games' | 'badges'

The column the page is ordered by. Defaults to signedUp for new and lastSeen for active

pageinteger required

1-based page number

sort'new' | 'active' required

new lists accounts by signup time, active lists them by their newest session activity

window'day' | 'week' | 'month' required

How far back the list goes

Example request

{
  "$schema": "https://api.steamsets.com/schemas/V1AdminListUsersRequestBody.json",
  "direction": "desc",
  "limit": 50,
  "orderBy": "level",
  "page": 1,
  "sort": "new",
  "window": "week"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

totalinteger required

How many accounts match the sort and window

Example response

{
  "$schema": "https://api.steamsets.com/schemas/V1AdminListUsersResponseBody.json",
  "summary": {
    "active": {
      "day": 40,
      "month": 1100,
      "week": 260
    },
    "signups": {
      "day": 40,
      "month": 1100,
      "week": 260
    },
    "totalUsers": 52000
  },
  "total": 260,
  "users": [
    {
      "account": {
        "apps": 123456,
        "avatar": "f1a1d2c3d0c9d1e1f2f3f4f5f6f7f8f9",
        "awardsGiven": 123456,
        "awardsReceived": 123456,
        "badges": 123456,
        "city": {
          "name": "Bad Krozingen"
        },
        "country": {
          "code": "DE",
          "name": "Germany"
        },
        "createdAt": "2023-01-01T00:00:00Z",
        "donated": 123456,
        "economyBan": "steam",
        "foilBadges": 123456,
        "friends": 123456,
        "level": 123456,
        "name": "steamsets",
        "nameEffect": "rainbow",
        "normalBadges": 123456,
        "playtime": 123456,
        "pointsGiven": 123456,
        "pointsReceived": 123456,
        "privacy": "public",
        "region": {
          "name": "Europe"
        },
        "state": {
          "name": "Baden-Wurttemberg"
        },
        "steamId": "76561198842603734",
        "steamSetsVanity": "steamsets",
        "steamVanity": "steamsets",
        "supporter": {
          "active": true,
          "months": 3
        },
        "themeColor": "#FF5733",
        "xp": 123456
      },
      "accountId": 882337740,
      "lastSeenAt": "2026-10-07T18:30:00Z",
      "restriction": {
        "kind": "staff",
        "reason": "Ban evasion",
        "restrictedAt": "2026-10-01T12:00:00Z"
      },
      "signedUpAt": "2026-10-01T12:00:00Z"
    }
  ]
}

Changes

  • 753b5a0546a3Revision changes
    • ○

      added the new optional request property

    • ○

      added the new required request property with a default value

    • ○

      added the optional property /// to the response with the status

    • ○

      added the required property // to the response with the status

    • ○

      added the required property // to the response with the status

  • 30a36433976cRevision changes
    • ○

      endpoint added

Of the 31 revisions, 1 has no diff computed.