---
title: "Marks of Excellence leaderboard"
method: GET
path: "/{region}/players/marks"
tags: ["Players"]
---

# Marks of Excellence leaderboard

`GET /{region}/players/marks`

## Request

- Base URL: `https://unicum.gg/api`
- URL: `https://unicum.gg/api/{region}/players/marks`
- Auth: none required

Players ranked by how many guns carry three Marks of Excellence, in total or at one tier. `tiers` names the tiers with a ranking, `coverage` says which accounts it is drawn from.

## Path parameters

- `region` 'eu' | 'na' | 'asia', required: Game server region.

## Query parameters

- `limit` integer: Maximum number of rows to return. Out-of-range values are clamped.
- `sort` string: Ranking column: `total` for three-mark guns across every tier, or `tier-<n>` for one tier (`tier-10`). Default `total`, which is also what an unrecognised value falls back to. Not an enum: which tiers the game has is Wargaming's to decide, and the response's `tiers` names the ones this region has a ranking for.
- `lang` string: Two-letter language code. When set, the leaderboard is filtered to players/clans whose clan declares this language (period is ignored: language boards are lifetime WNX).
- `strict` 'true' | 'false': With `lang`: only count clans that declare exactly this one language.

## Response `200`

Successful response

- PlayerMarksResponse
  - `results` MarksSummary[], required
    - `account_id` number, required
    - `nickname` string, required
    - `clan_tag` string, nullable, required
    - `clan_color` string, nullable, required
    - `battles` number, required
    - `wn7` number, nullable, required
    - `wn8` number, nullable, required
    - `wnx` number, nullable, required
    - `wn7_30d` number, nullable, required: WN7 over the last 30 days. Null for an account with no battle inside that window.
    - `wn8_30d` number, nullable, required: WN8 over the last 30 days. Null for an account with no battle inside that window.
    - `wnx_30d` number, nullable, required: WNX over the last 30 days. Null for an account with no battle inside that window.
    - `battles_30d` number, nullable, required: Battles played over the last 30 days, behind the three ratings above.
    - `marks3` number, required: Guns carrying three Marks of Excellence, every tier.
    - `marks3_by_tier` number[], required: Three-mark guns per tier, index 0 holding tier 1. Every tier column the board draws is read out of this. Shorter than the tier count when the player holds none at the top tiers.
    - `marks2` number, required
    - `marks1` number, required
    - `known` number, required: Vehicles a mark level was read for on this account, which is the row's own denominator: three marks mean more on a garage of forty than on one of nine hundred.
    - `measured_at` string, date-time, required: The newest observation these counts were taken from. Exact when the marks were read from the portal, and an upper bound for an account seeded from stored snapshots, since the bulk pipeline carries the last known marks forward without re-reading them.
    - `languages` string[], required: Languages inferred from the account's clan history, dominant first. Empty for an account we hold no history for.
    - `is_verified` boolean
    - `is_supporter` boolean
    - `twitch_login` string, nullable
    - `tournament_wins` number
    - `tournament_featured_wins` number
    - `tournament_best_title` string, nullable
    - `onslaught_best_tier` string, nullable
    - `onslaught_best_rank` number, nullable
    - `onslaught_seasons` number
  - `tiers` number[], required
  - `languages` MarksLanguageStats[], required
    - `code` string, required
    - `total` number, required
    - `strict` number, required: Accounts whose inferred set is exactly this language, with no co-dominant second one.
  - `coverage` MarksCoverage, required
    - `ranked` number, required: Accounts holding at least one three-mark gun.
    - `measured` number, required
    - `tracked` number, required
    - `min_battles` number, required: Battles an account needs before it is ranked here.
    - `newest` string, date-time, nullable, required
    - `oldest` string, date-time, nullable, required

---

[API](https://skmtc.dev/unicum/apis/unicum-gg-api.md) · [All operations](https://skmtc.dev/unicum/apis/unicum-gg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unicum/apis/unicum-gg-api/revisions/7a7d79a26001?raw)