---
title: "Player distribution"
method: GET
path: "/{region}/players/distribution"
tags: ["Players"]
---

# Player distribution

`GET /{region}/players/distribution`

## Request

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

How the region's tracked players are spread across win rate and WNX, as histograms, and how its battles are spread across tiers and vehicle classes. Materialised hourly rather than read live: the histograms are a full scan of the region's players. 404 until the first run. Dates are ISO 8601 strings.

## Path parameters

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

## Response `200`

Successful response

- PlayerDistribution: How a region's players and battles are distributed.
  - `region` 'eu' | 'na' | 'asia', required: Game server region.
  - `minBattles` number, required: Battles an account needs before it counts towards the histograms.
  - `players` number, required: Accounts that met the threshold.
  - `winrate` DistributionBucket[], required
    - `from` number, required
    - `to` number, required
    - `count` number, required
  - `ratings` object, required: One histogram per rating metric, so a reader's chosen metric is served rather than one being picked for them.
    - `wn7` DistributionBucket[], required
      - `from` number, required
      - `to` number, required
      - `count` number, required
    - `wn8` DistributionBucket[], required
      - `from` number, required
      - `to` number, required
      - `count` number, required
    - `wnx` DistributionBucket[], required
      - `from` number, required
      - `to` number, required
      - `count` number, required
  - `byTier` TierShare[], required
    - `tier` number, required
    - `tanks` number, required: Vehicles of this kind with tracked stats in the region.
    - `battles` number, required
    - `winrate` number, required: Battle-weighted mean win rate, 0..1.
  - `byType` TypeShare[], required
    - `type` 'heavyTank' | 'AT-SPG' | 'mediumTank' | 'lightTank' | 'SPG', required: Vehicle class.
    - `tanks` number, required: Vehicles of this kind with tracked stats in the region.
    - `battles` number, required
    - `winrate` number, required: Battle-weighted mean win rate, 0..1.
  - `computedAt` string, date-time, nullable, required: When the aggregate was last recomputed. It is materialised hourly rather than read live, since the histograms are a full scan of the region's players.

---

[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)