---
title: "Clan overview"
method: GET
path: "/{region}/clans/{tag}"
tags: ["Clans"]
---

# Clan overview

`GET /{region}/clans/{tag}`

## Request

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

The clan's profile and its battle-weighted aggregate ratings (lifetime and 30-day WN7/WN8/WNX plus the average win rate). The heavy per-category data lives on the dedicated sub-endpoints: `/members`, `/previous-clans`, `/activity`, `/stronghold`, `/clan-wars` and `/vehicles`. 404 if the region's clan with this tag doesn't exist.

## Path parameters

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

## Response `200`

Successful response

- ClanOverviewResponse
  - `clan` ClanInfo, required: Core clan profile.
    - `id` number, required
    - `tag` string, required
    - `name` string, required
    - `color` string, required
    - `emblem` string, required
    - `motto` string, required
    - `descriptionHtml` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, nullable, required
    - `membersCount` number, required
    - `leaderId` number, required
    - `leaderName` string, required
    - `creatorId` number, required
    - `creatorName` string, required
    - `isDisbanded` boolean, required
    - `languages` string[], required
  - `ratings` ClanRatings, required: The clan's battle-weighted aggregate ratings: lifetime and 30-day WN7/WN8/WNX (weighted by lifetime and recent battles), plus the lifetime average win rate.
    - `lifetime` RatingTriplet, required
      - `wn7` number, nullable, required
      - `wn8` number, nullable, required
      - `wnx` number, nullable, required
    - `recent` RatingTriplet, required
      - `wn7` number, nullable, required
      - `wn8` number, nullable, required
      - `wnx` number, nullable, required
    - `avgWinrate` number, nullable, required
  - `nameHistory` object[], required: Previous tags + names of this clan, newest first. Empty until a rename is observed.
    - `tag` string, required
    - `name` string, required
    - `recordedAt` string, date-time, required
  - `vehiclesCount` number, nullable, required: Distinct battle-having vehicle count for the clan, materialized from the last /vehicles load. Null until the vehicles tab has been opened at least once.
  - `badges` ClanRankBadge[], required: Podium positions the clan currently holds, best rank first. Only the top three of each leaderboard qualify, so this is empty for almost every clan.
    - `board` 'advances' | 't10' | 't8' | 't6', required: The leaderboard this placing is on.
    - `rank` integer, required
  - `tournamentWins` number, required: Tournaments won by a team attributed to this clan. The attribution is resolved from each roster as of the day it played, so an old title stays with the clan that actually fielded it.
  - `tournamentFeaturedWins` number, required: How many of those wins came at an event Wargaming flags as featured.
  - `tournamentBestTitle` string, nullable, required: The win worth naming: a featured event when there is one, else the most recent. Null when the clan has never won.
  - `tournamentCount` number, required: Tournaments the clan has fielded a team in, on the same attribution as the wins above. Counted here so a caller knows how much the /tournaments endpoint holds without reading it.

---

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