---
title: "List the global activity feed"
method: POST
path: "/v1/activity.listGlobalFeed"
tags: ["activity"]
---

# List the global activity feed

`POST /v1/activity.listGlobalFeed`

## Request body

- V1ActivityListGlobalFeedRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `cursor` string — Opaque pagination cursor from the previous page's nextCursor. Omit for the most recent page.
  - `eventTypes` string[], nullable — Filter to these event_type values (badge_crafted, level_milestone, rank_milestone, scarcity_milestone). Empty = all.
  - `limit` integer — Max events returned.

## Response `200`

OK

- V1ActivityListGlobalFeedResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `events` V1ActivityEvent[], nullable, required
    - `account` LeaderboardAccount, nullable
      - `animatedAvatar` string, required — The animated avatar of the account
      - `apps` integer, required — The number of apps the account has
      - `avatar` string, required — The avatar hash of the account
      - `avatarFrame` string, required — The avatar frame of the account
      - `awardsGiven` integer, required — The number of awards the account has
      - `awardsReceived` integer, required — The number of awards the account has
      - `background` string, required — The background of the account
      - `badges` integer, required — The number of badges the account has
      - `bans` integer, required — The number of bans
      - `city` LeaderboardCity, nullable
        - `name` string, required — The name of the city
      - `country` LeaderboardCountry, nullable
        - `code` string — The code of the country
        - `name` string, required — The name of the country
      - `createdAt` string, date-time, required — The time the account was created
      - `donated` integer, required — The total of donations the account has
      - `economyBan` string, required — The economy ban of the account
      - `foilBadges` integer, required — The number of foil badges the account has
      - `friends` integer, required — The number of friends the account has
      - `gameBans` integer, required — The number of game bans
      - `level` integer, required — The level of the account
      - `miniBackground` string, required — The mini background of the account
      - `name` string, required — The name of the account
      - `nameEffect` 'none' | 'rainbow' | 'glitch' | 'shadow' | 'neon' | 'retro' | 'stamped' | 'shatter' | 'typewriter' | 'vaporwave' | 'sunken', required — Donator name effect, none when unset or the account no longer holds an entitling role
      - `normalBadges` integer, required — The number of normal badges the account has
      - `playtime` integer, required — The playtime of the account
      - `pointsGiven` integer, required — The number of points the account has
      - `pointsReceived` integer, required — The number of points the account has
      - `privacy` 'public' | 'private' | 'friends_only', required — The privacy of the account
      - `region` LeaderboardRegion, nullable
        - `name` string, required — The name of the region
      - `roles` Role[], nullable, required — The roles of the account
        - `extras` object, nullable, required — Extra data associated with the role
        - `rating` integer, required — The higher the more presedence it has
        - `role` 'user' | 'donator' | 'staff' | 'developer' | 'partner' | 'owner' | 'amethyst' | 'amber' | 'emerald' | 'sapphire' | 'ruby' | 'diamond' | 'contributor' | 'early_supporter' | 'beta' | 'translator' | 'top_100' | 'badge_scout' | 'nitro_booster' | 'astral' | 'nebula', required
      - `state` LeaderboardState, nullable
        - `name` string, required — The name of the state
      - `steamId` string, required — The steam id
      - `steamSetsScore` integer, required — The steam sets score
      - `steamSetsVanity` string, required — The vanity of the account
      - `steamVanity` string, required — The vanity of the account
      - `themeColor` string, nullable, required — Donator profile theme color as #RRGGBB (no alpha), null when unset or the account no longer holds an entitling role
      - `vacBans` integer, required — The number of vac bans
      - `xp` integer, required — The number of xp the account has
    - `accountId` integer, required
    - `appBadge` V1AppBadge
      - `accountInfo` AccountBadgeInfo, nullable
        - `completionTime` string, date-time, required — The time the badge was completed
        - `level` integer, required — The level of the badge
        - `xp` integer, required — The xp of the badge
      - `appId` integer, required
      - `appImage` string, required
      - `appName` string, required
      - `badgeId` string, required
      - `badgeImage` string, required
      - `baseLevel` integer, required — The level this badge starts at
      - `baseXp` integer, required — The XP the badge gives per level
      - `cardCount` integer, required — Total trading cards Steam defines for this app (per side; foil and normal share the same count)
      - `firstCompletion` string, date-time, nullable, required
      - `highestLevel` integer, required
      - `isEvent` boolean, required
      - `isFoil` boolean, required
      - `isNmc` boolean, required — Whether the cards needed for this badge are non-marketable on Steam (cannot be bought/sold)
      - `isSale` boolean, required
      - `lastCompletion` string, date-time, nullable, required
      - `name` string, required
      - `noListing` boolean, required — Whether at least one card for this badge is not currently listed on the market
      - `price` integer, required
      - `scarcity` integer, required
      - `steamId` integer, required
      - `trackedHolders` integer, required
    - `eventType` string, required — badge_crafted | level_milestone | rank_milestone | scarcity_milestone
    - `level` V1ActivityLevelChange
      - `current` integer, required — Level after the milestone crossing
      - `previous` integer, required — Level before the milestone crossing
    - `occurredAt` string, date-time, required
    - `rank` V1ActivityRankChange
      - `bucket` string, required — top_10 | top_100 | top_1000
      - `current` integer, required — Rank after the change
      - `leaderboard` string, required — Leaderboard the rank was reached on
      - `location` V1ActivityLocation, required
        - `countryCode` string
        - `countryName` string
        - `region` string
        - `type` string, required — global | country | region
      - `previous` integer, required — Rank before the change (0 if previously unranked)
    - `scarcity` V1ActivityScarcity
      - `globalCraftOrder` integer, required — This account's global craft position for the badge (1 = first ever)
  - `nextCursor` string — Pass as cursor to fetch the next page. Absent when there are no more events.

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.net/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/versions/2e8ba266b27f/schema)