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

# Player sessions

`GET /{region}/players/{nickname}/sessions`

## Request

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

What a player played, session by session: battles, average tier, the vehicles taken out, and the per-battle averages and ratings of that stretch alone. The game keeps no session log and Wargaming exposes none, so each bucket is the difference between two consecutive snapshots of the player's vehicles, attributed to when it was observed. Bucketed by day, week or month; newest first. 404 when the player is unknown.

## Path parameters

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

## Query parameters

- `granularity` 'daily' | 'weekly' | 'monthly': Bucket size for the sessions.

## Response `200`

Successful response

- PlayerSessions: One player's play sessions, newest first.
  - `granularity` string, required
  - `sessions` PlayerSession[], required
    - `period` string, required: ISO date of the bucket's first day.
    - `tanks` integer, required: Distinct vehicles taken into battle.
    - `avgTier` number, nullable, required
    - `vehicles` SessionVehicle[], required
      - `tankId` integer, required
      - `slug` string, nullable, required
      - `name` string, required
      - `shortName` string, nullable, required
      - `tag` string, nullable, required
      - `tier` integer, nullable, required
      - `nation` string, nullable, required
      - `type` string, nullable, required
      - `isPremium` boolean, required
      - `isReward` boolean, required
      - `battles` integer, required
      - `winrate` number, required: Ratio in 0..1, not a percentage.
      - `avgDamage` number, required
      - `avgFrags` number, required
      - `avgSpotted` number, required
      - `avgDefense` number, required
      - `avgAssist` number, required
      - `avgXp` number, nullable, required
      - `survivalRate` number, nullable, required
      - `kd` number, nullable, required: Frags over deaths. Null when nothing died.
      - `damageRatio` number, nullable, required: Damage dealt over damage taken. Null on sessions whose snapshots predate that counter.
      - `wn7` number, nullable, required
      - `wn8` number, nullable, required
      - `wnx` number, nullable, required
    - `battles` integer, required
    - `winrate` number, required: Ratio in 0..1, not a percentage.
    - `avgDamage` number, required
    - `avgFrags` number, required
    - `avgSpotted` number, required
    - `avgDefense` number, required
    - `avgAssist` number, required
    - `avgXp` number, nullable, required
    - `survivalRate` number, nullable, required
    - `kd` number, nullable, required: Frags over deaths. Null when nothing died.
    - `damageRatio` number, nullable, required: Damage dealt over damage taken. Null on sessions whose snapshots predate that counter.
    - `wn7` number, nullable, required
    - `wn8` number, nullable, required
    - `wnx` number, 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)