---
title: "Resolve a roster"
method: GET
path: "/{region}/resolve"
tags: ["System"]
---

# Resolve a roster

`GET /{region}/resolve`

## Request

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

Everything about a set of players and clans in one call: language flags, lifetime and 30-day ratings, win rates, and the clan a player wears. Addressed by the ids a game client hands over, plus clan tags for the one roster that carries no id. Each list is optional, comma separated and capped at 100; a longer list is refused rather than truncated. An id we hold nothing for is absent from the response, while an entity we hold but have no language for is present with an empty `languages`. Reads cached data only, with no live Wargaming call.

## Path parameters

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

## Query parameters

- `players` number[]: Account ids. Up to 100.
- `clans` number[]: Clan ids. Up to 100.
- `tags` string[]: Clan tags, case-insensitive. Up to 100.

## Response `200`

Successful response

- ResolveResponse
  - `players` object, required
  - `clans` object, required
  - `tags` object, required: Tag to clan id, echoing back the tag as it was written. The clan itself is in `clans`, so a detachment list costs one request rather than one lookup per row and then a second request.

---

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