---
title: "Map detail"
method: GET
path: "/{region}/maps/{slug}"
tags: ["Maps"]
---

# Map detail

`GET /{region}/maps/{slug}`

## Request

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

A single battle map with its full geometry: display name, description, minimap image, camouflage kind, size in metres, battle timer, team size, and per-mode base flags, team spawns and control point projected onto the minimap as percentage coordinates. `randomEvents` carries the events that might fire on the map mid-battle, each with the minimap art of its danger area and of the ground it leaves behind. `rating` is the community verdict in three numbers, for a caller that needs a score and a count rather than the whole thing. `slug` in the response is the canonical slug.

## Path parameters

- `region` 'eu' | 'na' | 'asia', required: Game server region.
- `slug` string, required: Map slug (e.g. prokhorovka).

## Response `200`

Successful response

- MapDetailResponse: A battle map's gallery summary.
  - `arenaId` string, required
  - `slug` string, required
  - `name` string, required
  - `camouflage` 'summer' | 'winter' | 'desert', required: Vehicle camouflage kind the map is skinned with.
  - `sizeMeters` number, required: Square side length in metres.
  - `modes` MapModeField[], required
  - `battleTypes` MapBattleTypeField[], required
  - `minimapUrl` string, required
  - `bases` TeamMarkers, required
    - `team1` MapMarker[], required
      - `left` number, required
      - `top` number, required
    - `team2` MapMarker[], required
      - `left` number, required
      - `top` number, required
  - `hasRandomEvents` boolean, required: Whether random events might fire on the map mid-battle.
  - `commonTest` boolean, required: Whether only the Common Test client ships this map's space, so it cannot be played on the live server yet.
  - `variants` MapVariantLayout[], required: The map's variants in full, each its own arena drawn as its own view.
    - `arenaId` string, required
    - `battleType` 'random' | 'battle_royale' | 'frontline' | 'onslaught' | 'onslaught_night' | 'grand_battle' | 'clan_wars' | 'waffentrager' | 'last_stand' | 'arcade' | 'story_mode' | 'training', required: Top-level battle type a map belongs to.
    - `minimapUrl` string, required
    - `commonTest` boolean, required: Whether only the Common Test client ships this variant's space, so it cannot be played on the live server yet.
    - `widthMeters` number, required
    - `heightMeters` number, required
    - `geometry` MapModeGeometry[], required
      - `mode` 'standard' | 'encounter' | 'assault' | 'attack-defense', required: Random-battle game mode a map supports.
      - `label` string, required
      - `bases` TeamMarkers, required
        - `team1` MapMarker[], required
          - `left` number, required
          - `top` number, required
        - `team2` MapMarker[], required
          - `left` number, required
          - `top` number, required
      - `spawns` TeamMarkers, required
        - `team1` MapMarker[], required
          - `left` number, required
          - `top` number, required
        - `team2` MapMarker[], required
          - `left` number, required
          - `top` number, required
      - `controlPoint` MapMarker, required
        - `left` number, required
        - `top` number, required
    - `onslaught` MapOnslaught, required: One Onslaught (comp7) layout: minimap, reduced play area and geometry.
      - `arenaId` string, required: The arena this layout is defined by: the map itself, or the dedicated Onslaught arena the client ships beside it.
      - `minimapUrl` string, required
      - `widthMeters` number, required
      - `heightMeters` number, required
      - `spawns` TeamMarkers, required
        - `team1` MapMarker[], required
          - `left` number, required
          - `top` number, required
        - `team2` MapMarker[], required
          - `left` number, required
          - `top` number, required
      - `controlPoint` MapMarker, required
        - `left` number, required
        - `top` number, required
      - `pointsOfInterest` object[], required
        - `marker` MapMarker, required
          - `left` number, required
          - `top` number, required
        - `type` number, required: What taking the point gives the team: 1 artillery strike, 2 recon, 3 illumination flare.
  - `description` string, required
  - `roundLength` number, required: Battle timer in seconds.
  - `maxPlayersInTeam` number, required
  - `widthMeters` number, required
  - `heightMeters` number, required
  - `geometry` MapModeGeometry[], required
    - `mode` 'standard' | 'encounter' | 'assault' | 'attack-defense', required: Random-battle game mode a map supports.
    - `label` string, required
    - `bases` TeamMarkers, required
      - `team1` MapMarker[], required
        - `left` number, required
        - `top` number, required
      - `team2` MapMarker[], required
        - `left` number, required
        - `top` number, required
    - `spawns` TeamMarkers, required
      - `team1` MapMarker[], required
        - `left` number, required
        - `top` number, required
      - `team2` MapMarker[], required
        - `left` number, required
        - `top` number, required
    - `controlPoint` MapMarker, required
      - `left` number, required
      - `top` number, required
  - `onslaught` MapOnslaught, required: One Onslaught (comp7) layout: minimap, reduced play area and geometry.
    - `arenaId` string, required: The arena this layout is defined by: the map itself, or the dedicated Onslaught arena the client ships beside it.
    - `minimapUrl` string, required
    - `widthMeters` number, required
    - `heightMeters` number, required
    - `spawns` TeamMarkers, required
      - `team1` MapMarker[], required
        - `left` number, required
        - `top` number, required
      - `team2` MapMarker[], required
        - `left` number, required
        - `top` number, required
    - `controlPoint` MapMarker, required
      - `left` number, required
      - `top` number, required
    - `pointsOfInterest` object[], required
      - `marker` MapMarker, required
        - `left` number, required
        - `top` number, required
      - `type` number, required: What taking the point gives the team: 1 artillery strike, 2 recon, 3 illumination flare.
  - `randomEvents` MapRandomEvent[], required
    - `id` string, required
    - `name` string, required
    - `zoneUrls` string[], required: Minimap overlays marking where the event strikes, as the game marks it before it happens.
    - `afterUrls` string[], required: Minimap overlays redrawing the ground the event leaves behind.
  - `rating` object: The community verdict in three numbers, so a caller that only needs a score and a count does not have to ask for two histograms, two splits and thirty review bodies. The full verdict is `GET /{region}/maps/{slug}/ratings`.
    - `overall` number, nullable, required
    - `votes` integer, required
    - `reviewCount` integer, 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)