---
title: "List account owned apps"
method: POST
path: "/v1/account.listApps"
tags: ["account"]
---

# List account owned apps

`POST /v1/account.listApps`

## Request body

- V1AccountListAppsRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `filters` V1AppFilters
    - `appType` string, nullable — Filter by app type (e.g., 'game', 'dlc')
    - `excludeEvents` boolean, nullable — Exclude event apps
    - `excludeSales` boolean, nullable — Exclude sale/promotional apps
    - `hasBadge` boolean, nullable — If true, only apps where the account has crafted at least one badge; if false, only apps where it has crafted none
    - `playtime` Range
      - `max` integer — Maximum value (inclusive)
      - `min` integer — Minimum value (inclusive)
  - `id` IDSearch
    - `accountId` integer — Account ID to search for
    - `steamId64` string — SteamID64 to search for
  - `order` V1AppOrder, nullable
    - `by` 'appId' | 'playtime' | 'name' | 'cardCount' | 'setPrice', required
    - `direction` 'asc' | 'desc', required
  - `page` integer, required
  - `search` string, nullable
  - `vanity` VanitySearch
    - `type` 'steam' | 'internal', required — Which type of vanity to search for
    - `value` string, required — Vanity to search for

## Response `200`

OK

- V1AccountListAppsResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `apps` V1AccountApp[], nullable, required
    - `id` integer, required — The Steam App ID
    - `image` string, required — The App's image URL
    - `name` string, required — The App's name
    - `playtime` integer, required — The Account's playtime in the App
    - `price` integer, required — How much the app costs
  - `pages` integer, required — The number of pages
  - `totalHits` integer, required — The total number of hits for all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

> 11 revisions in range; 1 not diffed.

- **2026-08-09** `593d89718daa` — 4 info
  - added the new optional request property `filters/hasBadge`
  - added the new `cardCount` enum value to the request property `order/by`
  - added the new `name` enum value to the request property `order/by`
  - added the new `setPrice` enum value to the request property `order/by`

[Change history](https://skmtc.dev/steamsets/apis/steamsets-api/changes/v1/account.listApps/post.md)

---

[API](https://skmtc.dev/steamsets/apis/steamsets-api.md) · [All operations](https://skmtc.dev/steamsets/apis/steamsets-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/steamsets/steamsets-api/revisions/9930915a1df9/schema)