---
title: "Coverage"
method: GET
path: "/{region}/coverage"
tags: ["System"]
---

# Coverage

`GET /{region}/coverage`

## Request

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

How much of the region the tracker covers: player/clan/snapshot counts, refresh-policy health (per activity bucket), 30-day discovery and snapshot trends, and infrastructure size/cost. Cached for 60s server-side. Dates are ISO 8601 strings.

## Path parameters

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

## Response `200`

Successful response

- Coverage: Tracker coverage for one region: row counts, refresh-policy health, 30-day discovery/snapshot trends and infrastructure size/cost.
  - `region` 'eu' | 'na' | 'asia', required
  - `players` number, required
  - `clans` number, required
  - `playerSnapshots` number, required
  - `tankSnapshots` number, required
  - `clanMembers` number, required
  - `clanRecentEvents` number, required
  - `clanRefreshQueue` number, required
  - `playerRefreshQueue` number, required
  - `snapshotBacklog` number, required
  - `activity` object, required
    - `lastPlayerSnapshotAt` string, date-time, nullable, required
    - `lastClanRefreshAt` string, date-time, nullable, required
    - `playerSnapshotsLast24h` number, required
    - `clansRefreshedLast24h` number, required
    - `snapshotFreshness` object, required
      - `onTime` number, required
      - `fetched` number, required
    - `awaitingFirstSnapshot` number, required
  - `refreshPolicy` RefreshPolicyBucket[], required
    - `bucket` 'unfetched' | 'hidden' | 'active_24h' | 'active_7d' | 'recent_30d' | 'recent_90d' | 'dormant_1y' | 'inactive', required
    - `cadenceMs` number, required: Target refresh cadence for this activity bucket, in ms.
    - `total` number, required
    - `onTime` number, required
    - `neverSnapped` number, required
  - `funFacts` object, required
    - `oldestPlayerSnapshotAt` string, date-time, nullable, required
    - `biggestClan` object, nullable, required
      - `tag` string, required
      - `name` string, required
      - `membersCount` number, required
    - `totalBattlesTracked` number, required
    - `discordServers` number, nullable, required: Discord servers our bot is in. Global, not per region. Null when Discord could not be reached.
  - `trends` object, required
    - `playersDiscoveredDaily` DailyPoint[], required
      - `day` string, required: UTC day, YYYY-MM-DD.
      - `count` number, required
    - `clansDiscoveredDaily` DailyPoint[], required
      - `day` string, required: UTC day, YYYY-MM-DD.
      - `count` number, required
    - `playerSnapshotsDaily` DailyPoint[], required
      - `day` string, required: UTC day, YYYY-MM-DD.
      - `count` number, required
    - `firstSnapshotsDaily` DailyPoint[], required
      - `day` string, required: UTC day, YYYY-MM-DD.
      - `count` number, required
  - `infrastructure` object, required
    - `databaseBytes` number, required
    - `tables` object[], required
      - `name` string, required
      - `bytes` number, required
    - `costs` object, required
      - `recurring` ExpenseLine[], required
        - `label` string, required
        - `eurPerCharge` number, required: What a single charge costs. Subscriptions are prepaid, so the cumulative spend counts whole charges, never fractions of them.
        - `chargesPerYear` number, required: Charges in a year: 12 monthly, 1 yearly.
        - `eurAnnual` number, required
        - `eurMonthly` number, required
        - `from` string, required: UTC day it started, YYYY-MM-DD.
        - `to` string, nullable, required: UTC day it stopped, or null while still billed.
        - `note` string
      - `past` ExpenseLine[], required
        - `label` string, required
        - `eurPerCharge` number, required: What a single charge costs. Subscriptions are prepaid, so the cumulative spend counts whole charges, never fractions of them.
        - `chargesPerYear` number, required: Charges in a year: 12 monthly, 1 yearly.
        - `eurAnnual` number, required
        - `eurMonthly` number, required
        - `from` string, required: UTC day it started, YYYY-MM-DD.
        - `to` string, nullable, required: UTC day it stopped, or null while still billed.
        - `note` string
      - `oneOff` object[], required
        - `label` string, required
        - `eur` number, required
        - `incurredAt` string, required
        - `note` string
      - `totalAnnualEur` number, required
      - `totalOneOffEur` number, 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)