---
title: "List accounts that own an app (highest playtime first). Donator perk — page size scales with Patreon tier."
method: POST
path: "/v1/app.listOwners"
tags: ["app"]
---

# List accounts that own an app (highest playtime first). Donator perk — page size scales with Patreon tier.

`POST /v1/app.listOwners`

## Request body

- AppListOwnersRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `appId` integer, required — App id
  - `cursor` string — Opaque pagination cursor from the previous page's nextCursor. Omit for the first page.
  - `limit` integer — Page size (capped by donator tier)

## Response `200`

OK

- AppListOwnersResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `maxPageSize` integer, required — Largest page size your donator tier allows
  - `nextCursor` string — Pass as cursor to fetch the next page. Absent when there are no more owners.
  - `owners` AppListOwnersEntry[], nullable, required
    - `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 — Minutes this account has played the app
    - `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
  - `trackedOwners` integer, required — Owners steamsets tracks for this app

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[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/593d89718daa/schema)