---
title: "Get leaderboard history"
method: POST
path: "/v1/account.listLeaderboardHistory"
tags: ["account"]
---

# Get leaderboard history

`POST /v1/account.listLeaderboardHistory`

## Request body

- AccountSearch
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `id` IDSearch
    - `accountId` integer — Account ID to search for
    - `steamId64` string — SteamID64 to search for
  - `vanity` VanitySearch
    - `type` 'steam' | 'internal', required — Which type of vanity to search for
    - `value` string, required — Vanity to search for

## Response `200`

OK

- V1AccountListLeaderboardHistoryResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `histories` AccountLeaderboardHistory[], nullable, required
    - `date` string, date-time, required
    - `leaderboard` 'apps' | 'awards_given' | 'awards_received' | 'bans' | 'game_bans' | 'vac_bans' | 'foil_badges' | 'normal_badges' | 'badges' | 'playtime' | 'points_given' | 'points_received' | 'steam_sets' | 'xp', required
    - `rank` integer, required
    - `score` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `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/593d89718daa/schema)