Docs/CS2 API/CS2 Maps and Rounds API

CS2 Maps and Rounds API

Map-level data: the active duty pool with its dated history, the map catalog, and for each map played in a series its duration, player stats, round history, events and per-player economy (start money, spend and buy type each round). Grenade, kill and bomb positions and heatmaps for a map are in Positions & heatmaps.

7 endpoints in this section. Authenticate with the x-api-key header; every response is { success, data, meta }. Other sections: Live, Player props, Odds, Positions & heatmaps, Watch live (embeds), Pro skins & 3D, Matches, Rankings, Teams, Players, Events, Stats & leaderboards, Skins, Transfers, Search & reference.

Map player stats

GET/api/v1/cs2/games/{gameId}/stats
GET/api/v1/cs2/games/{gameId}/player-stats
GET/api/v1/cs2/maps/{mapId}/stats
GET/api/v1/cs2/maps/{mapId}/player-stats

Per-player stats for one map (game). These routes are equivalent; use whichever reads best.

Query parameters

ParameterTypeDescription
gameId (path)*stringGame (map) id from /cs2/matches/{matchId}/games.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/games/cs2-match-2399854-map-1/stats" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": [
    {
      "entityType": "cs2_player_stat",
      "id": "cs2-match-2399854-map-1-cs2-player-20447",
      "mapId": "cs2-match-2399854-map-1",
      "matchId": "cs2-match-2399854",
      "playerId": "cs2-player-20447",
      "playerName": "HeavyGod",
      "teamId": "cs2-team-5995",
      "teamName": "G2",
      "kills": 13,
      "deaths": 15,
      "assists": 1,
      "plusMinus": -2,
      "adr": 72.35,
      "kast": 0.5,
      "rating": 0.85,
      "ratingVersion": "cito_rating_1",
      "headshots": 6,
      "headshotPercent": 0.4615,
      "firstKills": 2,
      "firstDeaths": 2,
      "lastSyncedAt": "2026-11-11T12:56:41.809Z",
      "player": {
        "id": "cs2-player-20447",
        "nickname": "HeavyGod",
        "slug": "heavygod",
        "realName": "Nikita Martynenko",
        "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/a296b180d56afc8225017ecaa68217b6.webp",
        "countryName": "Israel",
        "countryCode": "IL",
        "age": 23,
        "rating": 1.09,
        "mapsPlayed": 127,
        "careerStats": {
          "rating": 1.09,
          "lastKnownRating": 1.09
        },
        "currentTeamId": "cs2-team-5995",
        "status": "active",
        "primaryRole": "rifler",
        "roleConfidence": "low",
        "statusUpdatedAt": "2026-11-11T12:51:52.813Z",
        "lastSyncedAt": "2026-11-11T12:57:12.514Z",
        "lastVerified": "2026-11-11T12:57:12.514Z",
        "imageIsPlaceholder": false
      },
      "team": {
        "id": "cs2-team-5995",
        "name": "G2",
        "slug": "g2",
        "teamTag": "G2",
        "logoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/a602501b47997540e5b51a5b49895204.webp",
        "countryName": "Europe",
        "countryCode": null,
        "region": "Europe",
        "worldRanking": 12,
        "lastSyncedAt": "2026-11-11T12:57:10.243Z",
        "lastVerified": "2026-11-11T12:57:10.243Z",
        "confidence": "high",
        "worldRankingStatus": "ranked",
        "vrsRanking": 12,
        "vrsRankingStatus": "ranked",
        "vrsRegion": "Europe",
        "logoIsPlaceholder": false
      },
      "availableSubresources": [],
      "…": "6 more fields"
    },
    {
      "entityType": "cs2_player_stat",
      "id": "cs2-match-2399854-map-1-cs2-player-21062",
      "mapId": "cs2-match-2399854-map-1",
      "matchId": "cs2-match-2399854",
      "playerId": "cs2-player-21062",
      "playerName": "MATYS",
      "teamId": "cs2-team-5995",
      "teamName": "G2",
      "kills": 11,
      "deaths": 15,
      "assists": 1,
      "plusMinus": -4,
      "adr": 65.4,
      "kast": 0.5,
      "rating": 0.78,
      "ratingVersion": "cito_rating_1",
      "headshots": 6,
      "headshotPercent": 0.5455,
      "firstKills": 3,
      "firstDeaths": 5,
      "lastSyncedAt": "2026-11-11T12:56:41.809Z",
      "player": {
        "id": "cs2-player-21062",
        "nickname": "MATYS",
        "slug": "matys",
        "realName": "Matúš Šimko",
        "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/66c5795b51cea5db7dfb8417d812e51b.webp",
        "countryName": "Slovakia",
        "countryCode": "SK",
        "age": 24,
        "rating": 1.05,
        "mapsPlayed": 111,
        "careerStats": {
          "rating": 1.05,
          "lastKnownRating": 1.05
        },
        "currentTeamId": "cs2-team-5995",
        "status": "active",
        "primaryRole": "entry",
        "roleConfidence": "m
…

Map rounds

GET/api/v1/cs2/games/{gameId}/rounds
GET/api/v1/cs2/maps/{mapId}/rounds

Round-by-round results for one map. Each round has `winnerSide` (`CT` / `T`), `winnerTeamId`, `winnerTeamName`, `winReason` (`t_killed`, `ct_killed`, `bomb_exploded`, `bomb_defused`, `time_ran_out`, `draw`; null when unknown), first kill / first death, `tKills`, `ctKills` and, where demo data exists, an `events` list in tick order. Every event has `type`, one of: `purchase` (a buy at freeze time, item in `weapon`), `equipment` (a loadout snapshot: helmet, defuser, kevlar, equipment value), `utility` (a grenade thrown), `damage` (`damage` dealt by `actor` to `target`), `kill` (`actor` killed `target`, with `assister`, `weapon`, `headshot`, `tradeKill`) and `clutch` (a 1vX situation). Bomb plants and defuses are not events here: `winReason` says how a round ended. Live webhook event names (`cs2.round.started` ...) are a different thing. Plans: round results are on every plan; the `events` list needs a paid plan for Free accounts created from 2026-10-28 (their rounds carry `eventsLocked: true` and a `roundEvents` note with the count and how to unlock it), and the dashboard sandbox shows it on any plan. A map without round data has `dataAvailable: false` and an `unavailableReason`: `not_yet_indexed` (the map ended recently; most maps get their rounds within a few hours), `demo_unavailable` (the map was played but no usable demo exists, so its rounds will not appear; `roundResultsUrl` links to `/cs2/live/{matchId}?include=rounds`, which has the winner and `winReason` of each round), `map_not_played` or `forfeit`. `objectiveStats.unavailableReason` is `not_recorded` when bomb plant, defuse and explosion events were not recorded for the map. These routes are equivalent; use whichever reads best.

Query parameters

ParameterTypeDescription
gameId (path)*stringGame (map) id from /cs2/matches/{matchId}/games.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/games/cs2-match-2399854-map-1/rounds" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_map_round_timeline",
    "mapId": "cs2-match-2399854-map-1",
    "dataScope": "round_summaries_kill_damage_utility_purchase_equipment_events",
    "unavailableEventTypes": [],
    "rounds": [
      {
        "id": "0ce24868-4f66-4b62-a882-860fdc761546",
        "matchId": "cs2-match-2399854",
        "mapId": "cs2-match-2399854-map-1",
        "round": 1,
        "startTick": 6507,
        "endTick": 10169,
        "durationTicks": 3662,
        "winnerSide": "T",
        "winnerTeamId": "cs2-team-4494",
        "winnerTeamName": "MOUZ",
        "winReason": "ct_killed",
        "firstKillPlayerId": "cs2-player-20312",
        "firstKillPlayerName": "xertioN",
        "firstKillTeamId": "cs2-team-4494",
        "firstDeathPlayerId": "cs2-player-21062",
        "firstDeathPlayerName": "MATYS",
        "firstDeathTeamId": "cs2-team-5995",
        "tKills": 5,
        "ctKills": 2,
        "killCount": 7,
        "events": [
          {
            "id": "f0504a70-bf29-4532-b319-344347a9fda4",
            "matchId": "cs2-match-2399854",
            "mapId": "cs2-match-2399854-map-1",
            "round": 1,
            "type": "purchase",
            "tick": 317,
            "seconds": 4.953,
            "actor": {
              "…": "…"
            },
            "target": {
              "…": "…"
            },
            "assister": {
              "…": "…"
            },
            "weapon": "Kevlar Vest",
            "headshot": false,
            "tradeKill": false,
            "damage": null,
            "confidence": "high",
            "lastSyncedAt": "2026-11-11T12:56:43.818Z",
            "details": {
              "…": "…"
            }
          },
          {
            "id": "e7736b26-62ff-4072-833b-e3b0ecca7bd1",
            "matchId": "cs2-match-2399854",
            "mapId": "cs2-match-2399854-map-1",
            "round": 1,
            "type": "purchase",
            "tick": 459,
            "seconds": 7.172,
            "actor": {
              "…": "…"
            },
            "target": {
              "…": "…"
            },
            "assister": {
              "…": "…"
            },
            "weapon": "Kevlar Vest",
            "headshot": false,
            "tradeKill": false,
            "damage": null,
            "confidence": "high",
            "lastSyncedAt": "2026-11-11T12:56:43.818Z",
            "details": {
              "…": "…"
            }
          }
        ],
        "confidence": "high",
        "lastSyncedAt": "2026-11-11T12:56:50.657Z"
      },
      {
        "id": "28db8147-39f2-4a89-9011-4c2dbcbe9227",
        "matchId": "cs2-match-2399854",
        "mapId": "cs2-match-2399854-map-1",
        "round": 2,
        "startTick": 11897,
        "endTick": 15905,
        "durationTicks": 4008,
        "winnerSide": "T",
        "winnerTeamId": "cs2-team-4494",
        "winnerTeamName": "MOUZ",
        "winReason": "ct_killed",
        "firstKillPlayerId": "cs2-player-20425",
        "firstKillPlayerName": "r1nkle",
        "firstKillTeamId": "cs2-team-5995",
        "firstDeathPlayerId": "cs2-player-20312",
        "firstDeathPlayerName": "xertioN",
        "firstDeathTeamId": "cs2-team-4494",
        "tKills": 5,
        "ctKills": 1,
        "killCount": 6,
        "events": [
          {
            "id": "f24fa91e-4a00-4bde-a17c-1d87adcc96c4",
            "matchId": "cs2-match-2399854",
            "mapId": "cs2-match-2399854-ma
…

Map events

GET/api/v1/cs2/games/{gameId}/events

Kills, utility, bomb and round events for one map, where demo data exists. Paid plans; Free accounts created from 2026-10-28 get 403 PLAN_REQUIRED (the dashboard sandbox shows it).

Query parameters

ParameterTypeDescription
gameId (path)*stringGame (map) id from /cs2/matches/{matchId}/games.
limitintegerRows to return. Maximum 5000; larger values are reduced to 5000.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/games/cs2-match-2399854-map-1/events" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": [
    {
      "id": "f0504a70-bf29-4532-b319-344347a9fda4",
      "matchId": "cs2-match-2399854",
      "mapId": "cs2-match-2399854-map-1",
      "round": 1,
      "type": "purchase",
      "tick": 317,
      "seconds": 4.953,
      "actor": {
        "playerId": "cs2-player-21062",
        "playerName": "MATYS",
        "teamId": "cs2-team-5995",
        "teamName": "G2",
        "side": null
      },
      "target": {
        "playerId": null,
        "playerName": null,
        "teamId": null,
        "teamName": null,
        "side": null
      },
      "assister": {
        "playerId": null,
        "playerName": null,
        "teamId": null,
        "teamName": null
      },
      "weapon": "Kevlar Vest",
      "headshot": false,
      "tradeKill": false,
      "damage": null,
      "confidence": "high",
      "lastSyncedAt": "2026-11-11T12:56:43.818Z",
      "details": {
        "itemName": "Kevlar Vest",
        "cost": 650,
        "wasSold": false,
        "inventory": [
          "Karambit",
          "Desert Eagle"
        ],
        "equipmentValue": 4250,
        "cashSpentThisRound": 650,
        "buyType": "full_buy",
        "hasHelmet": false,
        "hasDefuser": false
      }
    },
    {
      "id": "e7736b26-62ff-4072-833b-e3b0ecca7bd1",
      "matchId": "cs2-match-2399854",
      "mapId": "cs2-match-2399854-map-1",
      "round": 1,
      "type": "purchase",
      "tick": 459,
      "seconds": 7.172,
      "actor": {
        "playerId": "cs2-player-24457",
        "playerName": "xelex",
        "teamId": "cs2-team-4494",
        "teamName": "MOUZ",
        "side": null
      },
      "target": {
        "playerId": null,
        "playerName": null,
        "teamId": null,
        "teamName": null,
        "side": null
      },
      "assister": {
        "playerId": null,
        "playerName": null,
        "teamId": null,
        "teamName": null
      },
      "weapon": "Kevlar Vest",
      "headshot": false,
      "tradeKill": false,
      "damage": null,
      "confidence": "high",
      "lastSyncedAt": "2026-11-11T12:56:43.818Z",
      "details": {
        "itemName": "Kevlar Vest",
        "cost": 650,
        "wasSold": false,
        "inventory": [
          "Butterfly Knife",
          "Glock-18"
        ],
        "equipmentValue": 850,
        "cashSpentThisRound": 650,
        "buyType": "eco_or_pistol",
        "hasHelmet": false,
        "hasDefuser": false
      }
    }
  ],
  "meta": {
    "count": 2,
    "dataAvailable": true,
    "dataScope": "kill_damage_utility_purchase_equipment_events",
    "eventTypesAvailable": [
      "kill",
      "damage"
    ],
    "unavailableEventTypes": [],
    "limit": 2,
    "total": 2,
    "page": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

Map economy per player

GET/api/v1/cs2/games/{gameId}/economy/players
GET/api/v1/cs2/games/{gameId}/economy
GET/api/v1/cs2/maps/{mapId}/economy/players
GET/api/v1/cs2/maps/{mapId}/economy

Round-by-round economy of one map, per player. `by=player` (default), `by=team` or `by=round` (anything else is 400 `INVALID_BY`). The map id also works as `/cs2/games/{gameId}/economy` and `/cs2/matches/{matchId}/maps/{mapNumber}/economy` (each also with `/players`). `data`: `mapId`, `matchId`, `mapNumber`, `mapName`, `status`, `by`, `roundsCount`, `startMoneyAvailable`, `startMoneyCoverage` {playerRounds, withStartMoney}, `startMoneyUnavailableReason` (`not_recorded_for_this_map` for maps processed before 2026-11-02), `fields` (definitions), `dataAvailable`, `unavailableReason` (`round_economy_not_indexed`, `map_not_completed`). - `by=player`: `players[]` {playerId, playerName, teamId, teamName, rounds, `totals` {moneySpent, purchaseSpend, avgEquipmentValue, avgStartMoney, pistolRounds, ecoRounds, forceBuyRounds, halfBuyRounds, fullBuyRounds}, `byRound[]` {round, side, startMoney, moneySpent, moneyLeft, equipmentValue, roundStartEquipmentValue, buyType (`pistol`, `eco`, `force_buy`, `half_buy`, `full_buy`), purchases[] {item, cost, soldBack}, purchaseSpend, hasHelmet, hasDefuser, roundWon, freezeSnapshot}}. - `by=team`: `teams[]` {teamId, teamName, rounds[] {round, equipmentValue, moneySpent, startMoney, players, side, won}}. - `by=round`: `rounds[]` {round, teams[] {teamId, teamName, side, roundWon, equipmentValue, moneySpent, startMoney, players[]}}. Definitions: `startMoney` = money at round start (moneyLeft + moneySpent at the end of freeze time; correct across overtime money resets); `moneySpent`, `moneyLeft`, `equipmentValue` at the end of freeze time; `purchaseSpend` = the whole round's spend including buys after freeze time; `freezeSnapshot: false` = no end-of-freeze-time snapshot for that round. **Plans:** like round events, paid plans; Free accounts created from 2026-10-28 get 403 `PLAN_REQUIRED` (the dashboard sandbox shows it). Same response as `GET /api/v1/cs2/maps/{mapId}/economy`. These routes are equivalent; use whichever reads best.

Query parameters

ParameterTypeDescription
gameId (path)*stringGame (map) id from /cs2/matches/{matchId}/games.
bystringFilter by by.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/games/cs2-match-2399854-map-1/economy/players" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_map_player_economy",
    "mapId": "cs2-match-2399410-map-2",
    "matchId": "cs2-match-2399410",
    "mapNumber": 2,
    "mapName": "Anubis",
    "status": "completed",
    "by": "player",
    "roundsCount": 17,
    "startMoneyAvailable": true,
    "startMoneyCoverage": {
      "playerRounds": 170,
      "withStartMoney": 170
    },
    "startMoneyUnavailableReason": null,
    "fields": {
      "startMoney": "Money at the start of the round (before buying). Recorded for maps parsed from 2026-11-02.",
      "moneySpent": "Money spent by the end of freeze time.",
      "moneyLeft": "Money left at the end of freeze time.",
      "equipmentValue": "Value of the player's equipment at the end of freeze time.",
      "roundStartEquipmentValue": "Value of the gear the player carried in from the previous round.",
      "purchaseSpend": "Money spent in the whole round by the game's own counter, buys after freeze time included (purchases lists those buys…",
      "buyType": "pistol | eco | force_buy | half_buy | full_buy (from equipment value; rounds 1 and 13 are pistol rounds)."
    },
    "dataAvailable": true,
    "unavailableReason": null,
    "players": [
      {
        "playerId": "cs2-player-11840",
        "playerName": "Boombl4",
        "teamId": "cs2-team-12394",
        "teamName": "BETBOOM",
        "rounds": 17,
        "totals": {
          "moneySpent": 43700,
          "purchaseSpend": 46800,
          "avgEquipmentValue": 4303,
          "avgStartMoney": 6253,
          "pistolRounds": 2,
          "ecoRounds": 1,
          "forceBuyRounds": 0,
          "halfBuyRounds": 2,
          "fullBuyRounds": 12
        },
        "byRound": [
          {
            "round": 1,
            "side": "CT",
            "startMoney": 800,
            "moneySpent": 800,
            "moneyLeft": 0,
            "equipmentValue": 700,
            "roundStartEquipmentValue": 200,
            "buyType": "pistol",
            "purchases": [
              "…"
            ],
            "purchaseSpend": 800,
            "hasHelmet": false,
            "hasDefuser": false,
            "roundWon": true,
            "freezeSnapshot": true
          },
          {
            "round": 2,
            "side": "CT",
            "startMoney": 3500,
            "moneySpent": 3350,
            "moneyLeft": 150,
            "equipmentValue": 3550,
            "roundStartEquipmentValue": 200,
            "buyType": "half_buy",
            "purchases": [
              "…"
            ],
            "purchaseSpend": 3350,
            "hasHelmet": true,
            "hasDefuser": false,
            "roundWon": true,
            "freezeSnapshot": true
          }
        ]
      },
      {
        "playerId": "cs2-player-20357",
        "playerName": "d1Ledez",
        "teamId": "cs2-team-12394",
        "teamName": "BETBOOM",
        "rounds": 17,
        "totals": {
          "moneySpent": 48500,
          "purchaseSpend": 49000,
          "avgEquipmentValue": 4424,
          "avgStartMoney": 6776,
          "pistolRounds": 2,
          "ecoRounds": 1,
          "forceBuyRounds": 0,
          "halfBuyRounds": 1,
          "fullBuyRounds": 13
        },
        "byRound": [
          {
            "round": 1,
            "side": "CT",
            "startMoney": 800,
            "moneySpent": 650,
            "moneyLeft": 150,
            "equipmentValue": 850,
            "roundStartEquipmentValue": 200,
       
…

Game details

GET/api/v1/cs2/games/{gameId}

One map (game) of a match with score, halves and winner, and its wall-clock duration: `durationSeconds`, `startedAt`, `endedAt`, `durationTiming`, plus `duration.seconds` (see `/cs2/matches/{matchId}/maps`).

Query parameters

ParameterTypeDescription
gameId (path)*stringGame (map) id from /cs2/matches/{matchId}/games.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/games/cs2-match-2399854-map-1" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "id": "cs2-match-2399854-map-1",
    "entityType": "cs2_game",
    "matchId": "cs2-match-2399854",
    "mapNumber": 1,
    "map": "Nuke",
    "pickTeamId": null,
    "winnerTeamId": "cs2-team-4494",
    "score": {
      "team1": 13,
      "team2": 7
    },
    "halfScores": {
      "team1": [
        6,
        7
      ],
      "team2": [
        6,
        1
      ]
    },
    "team1Halves": [
      6,
      7
    ],
    "team2Halves": [
      6,
      1
    ],
    "overtime": null,
    "durationRounds": 20,
    "duration": {
      "rounds": 20,
      "seconds": null,
      "startedAt": null,
      "endedAt": "2026-11-11T10:17:22.960Z",
      "unavailableReason": "duration_no_round_timeline"
    },
    "status": "completed",
    "resultType": "played",
    "resultStatus": "completed",
    "isForfeit": false,
    "forfeitStage": null,
    "roundsPlayed": null,
    "statsEligible": true,
    "unavailableReason": null,
    "playerStatsAvailable": true,
    "playerStats": [
      {
        "playerId": "cs2-player-20447",
        "playerName": "HeavyGod",
        "teamId": "cs2-team-5995",
        "teamName": "G2",
        "kills": 13,
        "deaths": 15,
        "assists": 1,
        "plusMinus": -2,
        "adr": 72.35,
        "kast": 0.5,
        "rating": 0.85,
        "ratingVersion": "cito_rating_1",
        "headshots": 6,
        "headshotPercent": 0.4615,
        "openingKills": 2,
        "openingDeaths": 2,
        "ratingProfile": {
          "rating": 0.85,
          "ratingVersion": "cito_rating_1",
          "components": {
            "killsPerMap": 13,
            "adr": 72.35,
            "kast": 0.5,
            "killsPlusAssistsPerDeath": 0.9333
          },
          "openingDuels": {
            "openingKills": 2,
            "openingDeaths": 2,
            "successRate": 0.5
          },
          "formula": "Cito Rating 1.0 per map: 0.30*KPR/0.683 + 0.25*(1-DPR)/0.305 + 0.25*ADR/74.1 + 0.15*KAST/0.716 + 0.05*APR/0.223 (per-…"
        },
        "lastSyncedAt": "2026-11-11T12:56:41.809Z"
      },
      {
        "playerId": "cs2-player-21062",
        "playerName": "MATYS",
        "teamId": "cs2-team-5995",
        "teamName": "G2",
        "kills": 11,
        "deaths": 15,
        "assists": 1,
        "plusMinus": -4,
        "adr": 65.4,
        "kast": 0.5,
        "rating": 0.78,
        "ratingVersion": "cito_rating_1",
        "headshots": 6,
        "headshotPercent": 0.5455,
        "openingKills": 3,
        "openingDeaths": 5,
        "ratingProfile": {
          "rating": 0.78,
          "ratingVersion": "cito_rating_1",
          "components": {
            "killsPerMap": 11,
            "adr": 65.4,
            "kast": 0.5,
            "killsPlusAssistsPerDeath": 0.8
          },
          "openingDuels": {
            "openingKills": 3,
            "openingDeaths": 5,
            "successRate": 0.375
          },
          "formula": "Cito Rating 1.0 per map: 0.30*KPR/0.683 + 0.25*(1-DPR)/0.305 + 0.25*ADR/74.1 + 0.15*KAST/0.716 + 0.05*APR/0.223 (per-…"
        },
        "lastSyncedAt": "2026-11-11T12:56:41.809Z"
      }
    ],
    "…": "10 more fields"
  },
  "meta": {
    "dataAvailable": true
  }
}

Map catalog

GET/api/v1/cs2/maps

Every competitive map with its name and image.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/maps" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": [
    {
      "id": "de_ancient",
      "slug": "ancient",
      "name": "Ancient",
      "mapNameCanonical": "Ancient",
      "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
      "mapImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
      "coverImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png"
    },
    {
      "id": "de_anubis",
      "slug": "anubis",
      "name": "Anubis",
      "mapNameCanonical": "Anubis",
      "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/anubis.png",
      "mapImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/anubis.png",
      "coverImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/anubis.png"
    }
  ],
  "meta": {
    "count": 10,
    "dataAvailable": true,
    "unavailableReason": null,
    "limit": 10,
    "total": 10,
    "page": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

Active map pool

GET/api/v1/cs2/map-pool
GET/api/v1/cs2/maps/pool

The maps in the current competitive (Active Duty) pool, with dates from Valve's release notes: per map `inPoolSince` (start of the current window; for a removed map, its last window), `removedAt`, `poolWindows[]` {from, to}; `inPoolSinceBefore: "2021-05-04"` when the map was already in the pool before the history starts. `history[]` lists every pool change {at, added[], removed[], poolAfter[], sourceUrl, sourceTitle} since `historyStartsAt` (2021-05-04). These routes are equivalent; use whichever reads best.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/map-pool" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_active_duty_map_pool",
    "asOf": "2026-11-11",
    "poolName": "Active Duty",
    "inPoolCount": 7,
    "maps": [
      {
        "id": "de_ancient",
        "slug": "ancient",
        "name": "Ancient",
        "status": "in_pool",
        "inPoolSince": "2021-05-04",
        "inPoolSinceBefore": null,
        "removedAt": null,
        "poolWindows": [
          {
            "from": "2021-05-04T04:50:40.000Z",
            "to": null
          }
        ],
        "mapNameCanonical": "Ancient",
        "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
        "mapImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
        "coverImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
        "inPool": true,
        "pickTeamId": null,
        "objectiveStats": {
          "dataAvailable": false,
          "unavailableReason": "not_yet_indexed",
          "confidence": {
            "plants": "high",
            "defuses": "high",
            "explosions": "high",
            "clutchDefuse": "medium"
          },
          "teamStats": [],
          "roundEvents": []
        }
      },
      {
        "id": "de_anubis",
        "slug": "anubis",
        "name": "Anubis",
        "status": "in_pool",
        "inPoolSince": "2026-01-21",
        "inPoolSinceBefore": null,
        "removedAt": null,
        "poolWindows": [
          {
            "from": "2022-11-18T22:53:27.000Z",
            "to": "2025-07-16T00:01:30.000Z"
          },
          {
            "from": "2026-01-21T22:58:08.000Z",
            "to": null
          }
        ],
        "mapNameCanonical": "Anubis",
        "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/anubis.png",
        "mapImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/anubis.png",
        "coverImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/anubis.png",
        "inPool": true,
        "pickTeamId": null,
        "objectiveStats": {
          "dataAvailable": false,
          "unavailableReason": "not_yet_indexed",
          "confidence": {
            "plants": "high",
            "defuses": "high",
            "explosions": "high",
            "clutchDefuse": "medium"
          },
          "teamStats": [],
          "roundEvents": []
        }
      }
    ],
    "inPool": [
      {
        "id": "de_ancient",
        "slug": "ancient",
        "name": "Ancient",
        "status": "in_pool",
        "inPoolSince": "2021-05-04",
        "inPoolSinceBefore": null,
        "removedAt": null,
        "poolWindows": [
          {
            "from": "2021-05-04T04:50:40.000Z",
            "to": null
          }
        ],
        "mapNameCanonical": "Ancient",
        "imageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
        "mapImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
        "coverImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/ancient.png",
        "inPool": true
      },
      {
        "id": "de_anubis",
        "slug": "anubis",
        "name": "Anubis",
        "status": "in_pool",
        "inPoolSince": "2026-01-21",
        "inPoolSinceBefore": null,
        "removedAt": null,
        "poolWindows": [
          {
            "from": "2022-11-18T22:53:27.000Z",
            "to": "2025-07-16T00:01:30.000Z"
          }
…

Try the CS2 Maps and Rounds API

Run a real request with your key, then wire the same call into your app. The free plan includes 500 requests a month.

bash
curl "https://api.citoapi.com/api/v1/cs2/map-pool" \
  -H "x-api-key: YOUR_API_KEY"
Was this page helpful?