Docs/CS2 API/CS2 Live Scores API

CS2 Live Scores API

Everything about matches in progress: the live list, per-match state and scoreboard, rounds, kill events, live player stats, and the push stream so you do not have to poll. It follows the public scoreboard, which tournaments run behind a broadcast delay: built for live scoreboards, bots, overlays and models, not for betting on the next round.

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

Live update stream (SSE)

GET/api/v1/cs2/live/stream

Server-Sent Events stream of live match updates, on every plan. Keep the connection open; each `cs2.live.update` event carries the changed match (score, map, round), and each `cs2.live.players` event the state of every player (alive, hp, money, weapon, K/D). Pass `matchId` to follow one match. Events: `ready` (sent first; carries `delay_seconds`, `billing` and the event names in `events`), `cs2.live.update`, `cs2.live.players`, `ping` every 15 seconds, and `error` just before the server closes the stream. **Billing.** An open stream counts toward your monthly quota like polling: one request when it connects, then one request for every 15 seconds it stays open (the same as polling `/cs2/live` every 15 seconds; 5,760 requests a day if held open around the clock). When the quota runs out the stream sends an `error` event with code `RATE_LIMIT_EXCEEDED` and closes; connecting with no quota left returns 429. **Delay.** Free and Starter plans receive every update 60 seconds late, the same delay as the polled live endpoints; player state (`cs2.live.players`) is held for the same 60 seconds as the score, so it never runs ahead of it. Other plans are real-time. **Players (`cs2.live.players`).** Every player of the map in play, sent whenever any of it changes and at most once per match per second (changes inside that second arrive as one event with the newest state; an unchanged state is not sent again). Fields: `matchId`, `map`, `currentRound`, `roundScore` {`team1`, `team2`} (rounds on this map), `bombPlanted`, `teams[]` {`id`, `name`, `side` (`CT`/`T`), `playersAlive`, `money`}, `players[]` {`id`, `nickname`, `teamId`, `side`, `alive`, `hp`, `armor`, `helmet`, `money`, `weapon`, `kills`, `assists`, `deaths`, `adr`, `kast`, `rating`, `ratingVersion`, `entryKills`, `entryDeaths`, `headshots`, `roundsPlayed`} and `capturedAt`. These are the same player fields as `players` on `GET /cs2/live/{matchId}/scoreboard` (and `/state`), which you can poll instead. A new stream receives the players its delay allows right away when we hold them, otherwise with the next change. Live data has no player positions: x/y positions are served for finished maps only (`/cs2/maps/{mapId}/positions`). Room-based WebSockets (Scale and Enterprise, or the Live WebSockets add-on): `wss://api.citoapi.com/api/v1/cs2/live/ws`. The socket sends the same `cs2.live.update` and `cs2.live.players` events plus, for keys whose plan includes odds, `cs2.odds.updated` for every market price change in the rooms you joined (and `cs2.odds.snapshot` with the current prices when you join a match room): `matchId`, `market`, `team1Odds`, `team2Odds`, implied probabilities, `previousTeam1Odds`/`previousTeam2Odds`, `marketStatus`, `bestBid`/`bestAsk`/`spread`, `liquidityUsd`, `live` {`mapNumber`, `round`, `roundPhase`, round score, `ctTeam`/`tTeam`, `bombPlanted`}, `sourceTimestamp`, `publishedAt`, `sentAt`. Measured on live CS2 matches (November 2026): a price change reaches WebSocket clients in about 0.3 s (95% within 0.4 s, 99% within 0.6 s) after the market moved; REST returns it from the next call. A rare database stall can hold a change back for up to about 40 s. The `ready` message says whether your key gets odds (`odds.enabled`); subscribe with `odds: false` to turn them off.

Query parameters

ParameterTypeDescription
matchIdstringMatch id.

Example

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

Response

json
event: cs2.live.update
data: {"type":"cs2.live.update","matchId":"cs2-match-2400465","map":"de_inferno","currentRound":23,"team1Score":12,"team2Score":11,"bombPlanted":false,"capturedAt":"2026-11-11T20:33:19.424Z"}

event: cs2.live.players
data: {"type":"cs2.live.players","matchId":"cs2-match-2400465","map":"de_inferno","currentRound":23,"roundScore":{"team1":12,"team2":11},"players":[{"id":"cs2-player-24173","nickname":"tenzy","alive":true,"hp":67,"money":3500,"weapon":"ak47"}]}

Live socket details

GET/api/v1/cs2/live/{matchId}/socket

Connection details for subscribing to one live match over the live stream.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.

Example

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

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_live_transport",
    "matchId": "cs2-match-2400390",
    "transports": {
      "websocket": {
        "url": "wss://api.citoapi.com/api/v1/cs2/live/ws?matchId=cs2-match-2400390",
        "auth": "x-api-key header, Authorization: Bearer, or ?apiKey=",
        "subscribe": {
          "action": "subscribe",
          "rooms": [
            "match:cs2-match-2400390"
          ]
        },
        "allLiveMatches": {
          "action": "subscribe",
          "rooms": [
            "all"
          ]
        },
        "messages": [
          "ready",
          "cs2.live.snapshot (on subscribe)"
        ],
        "plans": "Scale / Enterprise, or the Live WebSockets add-on"
      },
      "sse": {
        "url": "/api/v1/cs2/live/stream?matchId=cs2-match-2400390",
        "note": "Same events as the WebSocket. Connect with Accept: text/event-stream. Available on every plan.",
        "billing": "Counts like polling: one request at connect, then one for every 15 seconds the stream stays open. When the monthly qu…",
        "delay": "Plans below Pro receive every update 60 seconds late, like the polled live endpoints. Pro and above are real-time."
      }
    },
    "v2Shape": "Append ?shape=v2 on REST live endpoints or send Accept: application/vnd.cito.cs2.v2+json"
  },
  "meta": {}
}

Live scoreboard

GET/api/v1/cs2/live/{matchId}/scoreboard

Series score, current map and round, the round score (`game.score`, per team `mapScore`), and per-player kills, deaths, assists, ADR, money and equipment for a live match. Each player also carries live `kast` (share of rounds played, 0-1), `rating` (Cito Rating, `ratingVersion: cito_rating_1_live`, the same formula as the post-match rating), `entryKills`, `entryDeaths`, `headshots` and `roundsPlayed`, updated every round. At the final round of a map they are the numbers for that map, ready for a map-end graphic. They are null in round 0 and on the frame where the scoreboard switches maps. The same players are pushed, when they change, as the `cs2.live.players` event on `/cs2/live/stream` and the CS2 live WebSocket.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.

Example

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

Response

json
{
  "success": true,
  "data": {
    "matchId": "cs2-match-2400390",
    "status": "live",
    "bestOf": 3,
    "currentGame": 1,
    "seriesScore": {
      "teamA": 0,
      "teamB": 0
    },
    "game": {
      "id": "cs2-match-2400390_de_mirage",
      "map": "de_mirage",
      "round": 19,
      "phase": "live",
      "clockSeconds": null,
      "bomb": null,
      "score": {
        "ct": 6,
        "t": 13
      },
      "sides": {
        "ctTeamId": "cs2-team-14124",
        "tTeamId": "cs2-team-12889"
      }
    },
    "teams": [
      {
        "id": "cs2-team-12889",
        "name": "G2 Ares",
        "side": "T",
        "score": 0,
        "mapScore": 13,
        "playersAlive": 3,
        "equipmentValue": null,
        "money": 19700,
        "timeoutsRemaining": null
      },
      {
        "id": "cs2-team-14124",
        "name": "Lunacy",
        "side": "CT",
        "score": 0,
        "mapScore": 6,
        "playersAlive": 0,
        "equipmentValue": null,
        "money": 1000,
        "timeoutsRemaining": null
      }
    ],
    "players": [
      {
        "id": "cs2-player-23237",
        "nickname": "TMKj",
        "teamId": "cs2-team-12889",
        "side": "T",
        "alive": false,
        "hp": 0,
        "armor": null,
        "helmet": false,
        "money": 7750,
        "weapon": null,
        "kills": 24,
        "assists": 1,
        "deaths": 11,
        "adr": 127.47368421052632,
        "kast": 0.7895,
        "rating": 1.51,
        "ratingVersion": "cito_rating_1_live",
        "entryKills": 4,
        "entryDeaths": 0,
        "headshots": 18,
        "roundsPlayed": 19
      },
      {
        "id": "cs2-player-25576",
        "nickname": "yksjupe",
        "teamId": "cs2-team-12889",
        "side": "T",
        "alive": false,
        "hp": 0,
        "armor": null,
        "helmet": false,
        "money": 1350,
        "weapon": null,
        "kills": 21,
        "assists": 4,
        "deaths": 12,
        "adr": 99.3157894736842,
        "kast": 0.8421,
        "rating": 1.35,
        "ratingVersion": "cito_rating_1_live",
        "entryKills": 4,
        "entryDeaths": 1,
        "headshots": 10,
        "roundsPlayed": 19
      }
    ],
    "lastEvent": {
      "id": null,
      "type": "BombPlanted",
      "round": 19,
      "clockSeconds": null,
      "killerPlayerId": null,
      "victimPlayerId": null,
      "weapon": null,
      "headshot": null,
      "throughSmoke": null
    },
    "meta": {
      "updatedAt": "2026-11-11T12:57:08.437Z",
      "latencyMs": null,
      "coverage": "realtime",
      "unavailableFields": [
        "game.clockSeconds"
      ]
    }
  },
  "meta": {}
}

Live rounds

GET/api/v1/cs2/live/{matchId}/rounds

Round-by-round results so far in a live match: winner, side and how the round ended.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.
limitintegerRows to return. Maximum 500; larger values are reduced to 500.

Example

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

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_live_rounds",
    "matchId": "cs2-match-2400390",
    "rounds": [
      {
        "eventId": "2dc613574d71227e081e738bc511e02b",
        "eventType": "RoundEnd",
        "winner": "TERRORIST",
        "winType": "Terrorists_Win",
        "terroristScore": 12,
        "counterTerroristScore": 6,
        "payload": {
          "counterTerroristScore": 6,
          "terroristScore": 12,
          "winner": "TERRORIST",
          "winType": "Terrorists_Win"
        },
        "observedAt": "2026-11-11T12:54:57.635Z"
      },
      {
        "eventId": "1b03b2dbf4a7d10e59a72735915076ed",
        "eventType": "RoundEnd",
        "winner": "TERRORIST",
        "winType": "Terrorists_Win",
        "terroristScore": 13,
        "counterTerroristScore": 6,
        "payload": {
          "counterTerroristScore": 6,
          "terroristScore": 13,
          "winner": "TERRORIST",
          "winType": "Terrorists_Win"
        },
        "observedAt": "2026-11-11T12:56:43.218Z"
      }
    ],
    "currentRound": 19
  },
  "meta": {
    "count": 2,
    "limit": 2,
    "total": 20,
    "page": 1,
    "totalPages": 10,
    "hasNext": true,
    "hasPrev": false
  }
}

Live events

GET/api/v1/cs2/live/{matchId}/events

Kills, bomb plants and defuses, and round ends recorded during a live match.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.

Example

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

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_live_events",
    "matchId": "cs2-match-2400390",
    "events": [
      {
        "eventId": "8be66aa1308d1c6412dcce5b8ea336ee",
        "eventType": "BombPlanted",
        "playerName": "z3ndeR",
        "playerNick": "z3ndeR",
        "ctPlayers": 4,
        "tPlayers": 2,
        "bombSite": "B",
        "payload": {
          "playerName": "z3ndeR",
          "playerNick": "z3ndeR",
          "ctPlayers": 4,
          "tPlayers": 2,
          "bombSite": "B"
        },
        "logRound": null,
        "observedAt": "2026-11-11T11:56:36.308Z"
      },
      {
        "eventId": "eaf3feb3b645ae729e78aeaeaee4784c",
        "eventType": "BombPlanted",
        "playerName": "z3ndeR",
        "playerNick": "z3ndeR",
        "ctPlayers": 1,
        "tPlayers": 3,
        "bombSite": "B",
        "payload": {
          "playerName": "z3ndeR",
          "playerNick": "z3ndeR",
          "ctPlayers": 1,
          "tPlayers": 3,
          "bombSite": "B"
        },
        "logRound": 2,
        "observedAt": "2026-11-11T11:58:57.857Z"
      }
    ]
  },
  "meta": {
    "count": 32,
    "limit": 32,
    "total": 32,
    "page": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

Live player stats

GET/api/v1/cs2/live/{matchId}/player-stats

Running per-player stats for a live match.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.

Example

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

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_live_player_stats",
    "matchId": "cs2-match-2400390",
    "status": "live",
    "isCurrent": true,
    "dataAvailable": true,
    "unavailableReason": null,
    "capturedAt": "2026-11-11T12:57:08.437Z",
    "players": [
      {
        "playerId": "cs2-player-23237",
        "name": "TMKj",
        "nick": "TMKj",
        "side": "T",
        "alive": false,
        "hp": 0,
        "money": 7750,
        "kills": 24,
        "assists": 1,
        "deaths": 11,
        "adr": 127.47368421052632,
        "kast": 0.7895,
        "rating": 1.51,
        "ratingVersion": "cito_rating_1_live",
        "entryKills": 4,
        "entryDeaths": 0,
        "headshots": 18,
        "roundsPlayed": 19,
        "weapon": null,
        "weaponIconUrl": null,
        "hasDefuseKit": false,
        "kevlar": false,
        "helmet": false
      },
      {
        "playerId": "cs2-player-25576",
        "name": "yksjupe",
        "nick": "yksjupe",
        "side": "T",
        "alive": false,
        "hp": 0,
        "money": 1350,
        "kills": 21,
        "assists": 4,
        "deaths": 12,
        "adr": 99.3157894736842,
        "kast": 0.8421,
        "rating": 1.35,
        "ratingVersion": "cito_rating_1_live",
        "entryKills": 4,
        "entryDeaths": 1,
        "headshots": 10,
        "roundsPlayed": 19,
        "weapon": null,
        "weaponIconUrl": null,
        "hasDefuseKit": false,
        "kevlar": false,
        "helmet": false
      }
    ],
    "lastVerified": "2026-11-11T12:57:08.486Z"
  },
  "meta": {
    "count": 10,
    "dataAvailable": true,
    "confirmationMaxAgeMs": 45000,
    "limit": 10,
    "total": 10,
    "page": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

Live maps

GET/api/v1/cs2/live/{matchId}/maps

Map list for a live match with per-map score and status.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.

Example

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

Response

json
{
  "success": true,
  "data": [
    {
      "entityType": "cs2_map",
      "id": "cs2-match-2400390-map-1",
      "matchId": "cs2-match-2400390",
      "mapNumber": 1,
      "mapName": "Mirage",
      "status": "live",
      "team1Score": 13,
      "team2Score": 6,
      "team1Halves": [
        8
      ],
      "team2Halves": [
        4
      ],
      "winnerTeamId": null,
      "durationRounds": null,
      "lastSyncedAt": "2026-11-11T12:57:08.616Z",
      "playerStats": [
        {
          "id": "cs2-match-2400390-map-1-cs2-player-21369",
          "mapId": "cs2-match-2400390-map-1",
          "matchId": "cs2-match-2400390",
          "playerId": "cs2-player-21369",
          "playerName": "1NVISIBLEE",
          "teamId": "cs2-team-14124",
          "teamName": "Lunacy",
          "kills": 5,
          "deaths": 14,
          "assists": 3,
          "plusMinus": -9,
          "adr": 46.59,
          "kast": 0.5,
          "rating": 0.58,
          "ratingVersion": "cito_rating_1",
          "headshots": 4,
          "headshotPercent": 0.8,
          "firstKills": 1,
          "firstDeaths": 5,
          "lastSyncedAt": "2026-11-11T12:53:33.542Z",
          "mapNameCanonical": null,
          "imageUrl": null,
          "mapImageUrl": null,
          "coverImageUrl": null,
          "…": "8 more fields"
        },
        {
          "id": "cs2-match-2400390-map-1-cs2-player-24111",
          "mapId": "cs2-match-2400390-map-1",
          "matchId": "cs2-match-2400390",
          "playerId": "cs2-player-24111",
          "playerName": "Junyme",
          "teamId": "cs2-team-12889",
          "teamName": "G2 Ares",
          "kills": 4,
          "deaths": 10,
          "assists": 1,
          "plusMinus": -6,
          "adr": 28.94,
          "kast": 0.625,
          "rating": 0.66,
          "ratingVersion": "cito_rating_1",
          "headshots": 0,
          "headshotPercent": 0,
          "firstKills": 1,
          "firstDeaths": 2,
          "lastSyncedAt": "2026-11-11T12:53:33.542Z",
          "mapNameCanonical": null,
          "imageUrl": null,
          "mapImageUrl": null,
          "coverImageUrl": null,
          "…": "8 more fields"
        }
      ],
      "bombEvents": [],
      "bombStats": [],
      "weaponAggregates": [],
      "mapImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/maps/mirage.png",
      "pickTeamId": "cs2-team-14124",
      "objectiveStats": {
        "dataAvailable": false,
        "unavailableReason": "not_yet_indexed",
        "confidence": {
          "plants": "high",
          "defuses": "high",
          "explosions": "high",
          "clutchDefuse": "medium"
        },
        "teamStats": [],
        "roundEvents": []
      },
      "durationSeconds": null,
      "startedAt": null,
      "endedAt": null,
      "durationTiming": {
        "seconds": null,
        "minutes": null,
        "startedAt": null,
        "endedAt": null,
        "definition": "Round 1 freeze-time end to the last round end, wall clock, timeouts and pauses included.",
        "round1FreezeEndRecorded": null,
        "unavailableReason": "map_in_progress"
      },
      "…": "18 more fields"
    },
    {
      "entityType": "cs2_map",
      "id": "cs2-match-2400390-map-2",
      "matchId": "cs2-match-2400390",
      "mapNumber": 2,
      "mapName": "Inferno",
      "status": "upcoming",
      "team1Score": null,
      "team2Score": null,
      "team1Halves": null,
      "team2Halves": null,
      "winn
…

Live snapshots

GET/api/v1/cs2/live/{matchId}/snapshots

Timestamped snapshots of a live match (score, round, players) so the match can be replayed over time. Filter with `from` / `to`.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.
fromstringStart of the date range (ISO 8601, UTC).
includestringFilter by include.
limitintegerRows to return. Maximum 100; larger values are reduced to 100.
rankingstringRanking to use: omit for Valve Regional Standings, or world for the world ranking filtered to this region.
tostringEnd of the date range (ISO 8601, UTC).

Example

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

Response

json
{
  "success": true,
  "data": [],
  "meta": {
    "count": 0,
    "excludedEmpty": 2,
    "dataAvailable": true,
    "limit": 0,
    "total": 0,
    "page": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

Live state

GET/api/v1/cs2/live/{matchId}/state

The latest state of one live match: score, round, round timer, bomb status and players.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.

Example

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

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_live_state",
    "matchId": "cs2-match-2400390",
    "status": "live",
    "teams": {
      "team1Id": "cs2-team-12889",
      "team1Name": "G2 Ares",
      "team1LogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/9158a57c6e0e020169cc9b45501d3073.webp",
      "team1AlternateLogoUrl": null,
      "team1DarkUiLogoUrl": null,
      "team2Id": "cs2-team-14124",
      "team2Name": "Lunacy",
      "team2LogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/bfbc6dd5ae5abc9b6db84eff3cd5b45a.webp",
      "team2AlternateLogoUrl": null,
      "team2DarkUiLogoUrl": null,
      "team1LogoIsPlaceholder": false,
      "team2LogoIsPlaceholder": false
    },
    "score": {
      "team1": 13,
      "team2": 6
    },
    "currentMap": "de_mirage",
    "currentRound": 19,
    "roundTimeSeconds": null,
    "roundTimeLeft": null,
    "currentScoreCt": 6,
    "currentScoreT": 13,
    "ctTeam": "team2",
    "tTeam": "team1",
    "bombPlanted": false,
    "players": [
      {
        "playerId": "cs2-player-23237",
        "name": "TMKj",
        "nick": "TMKj",
        "side": "T",
        "alive": false,
        "hp": 0,
        "money": 7750,
        "kills": 24,
        "assists": 1,
        "deaths": 11,
        "adr": 127.47368421052632,
        "kast": 0.7895,
        "rating": 1.51,
        "ratingVersion": "cito_rating_1_live",
        "entryKills": 4,
        "entryDeaths": 0,
        "headshots": 18,
        "roundsPlayed": 19,
        "weapon": null,
        "weaponIconUrl": null,
        "hasDefuseKit": false,
        "kevlar": false,
        "helmet": false
      },
      {
        "playerId": "cs2-player-25576",
        "name": "yksjupe",
        "nick": "yksjupe",
        "side": "T",
        "alive": false,
        "hp": 0,
        "money": 1350,
        "kills": 21,
        "assists": 4,
        "deaths": 12,
        "adr": 99.3157894736842,
        "kast": 0.8421,
        "rating": 1.35,
        "ratingVersion": "cito_rating_1_live",
        "entryKills": 4,
        "entryDeaths": 1,
        "headshots": 10,
        "roundsPlayed": 19,
        "weapon": null,
        "weaponIconUrl": null,
        "hasDefuseKit": false,
        "kevlar": false,
        "helmet": false
      }
    ],
    "liveBombEvents": [
      {
        "eventId": "8be66aa1308d1c6412dcce5b8ea336ee",
        "eventType": "BombPlanted",
        "playerName": "z3ndeR",
        "playerNick": "z3ndeR",
        "ctPlayers": 4,
        "tPlayers": 2,
        "bombSite": "B",
        "observedAt": "2026-11-11T11:56:36.308Z"
      },
      {
        "eventId": "eaf3feb3b645ae729e78aeaeaee4784c",
        "eventType": "BombPlanted",
        "playerName": "z3ndeR",
        "playerNick": "z3ndeR",
        "ctPlayers": 1,
        "tPlayers": 3,
        "bombSite": "B",
        "observedAt": "2026-11-11T11:58:57.857Z"
      }
    ],
    "roundEndEvents": [
      {
        "eventId": "340f58d180b907c011bbdb9e2bc18f4c",
        "winnerSide": "CT",
        "winnerSideIcon": "ct",
        "winnerSideIconUrl": "/icons/cs2/ct_win.svg",
        "winType": "Bomb_Defused",
        "winKind": "defuse",
        "winKindIconUrl": "/icons/cs2/bomb_defused.svg",
        "terroristScore": 0,
        "counterTerroristScore": 1,
        "observedAt": "2026-11-11T11:57:00.279Z"
      },
      {
        "eventId": "8db0491a60f15fb7eeeeeacee9bad18c",
        "winnerSide": "TERRORIST",
        "winnerSideIcon": "t",
        "wi
…

Live match

GET/api/v1/cs2/live/{matchId}

One live match with teams, series score and live-coverage details. **Round history for every map in one call:** add `?include=rounds`. The response then carries `mapRounds`, one entry per map played so far (finished maps and the map in play): - `mapNumber`, `mapName`, `status`, `team1Score`, `team2Score`: the map, as in `/cs2/live/{matchId}/maps`. - `rounds`: `round` (1, 2, ...), `winnerSide` (`CT` / `T`), `winnerTeamId`, `winnerTeamName`, `winReason` (`t_killed`, `ct_killed`, `bomb_exploded`, `bomb_defused`, `time_ran_out`) and `endedAt` when known. - `complete`: `true` when every round is there. For a finished map that also means the rounds each team won add up to the map score; for the map in play, that no round so far is missing. - `missingRounds`: round numbers we hold no result for. The team is `null` on a round where it cannot be stated with certainty (some overtime rounds). - `source`: `live` (recorded as the match was played) or `post_match` (from the match recording, once it is processed). Without `include`, the response is unchanged. Live-data delay on your plan applies to this endpoint as a whole, `mapRounds` included. **Stream to embed:** `streams` is `{ count, languages, official, href }`: `official` is the organiser's broadcast (`platform`, `channel` or `videoId`, `embedUrl`, `embedUrlTemplate`, `requiresParent`) or null, and `href` is the full list (`/cs2/matches/{matchId}/streams`). For Twitch, `embedUrl` is null here: replace `{parent}` in `embedUrlTemplate` with your page's hostname. `streams` is null when no broadcast is known.

Query parameters

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.
includestringrounds adds mapRounds: the round history of every map played so far (see below).

Example

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

Response

json
{
  "success": true,
  "data": {
    "entityType": "cs2_live_match",
    "id": "cs2-match-2400390",
    "matchId": "cs2-match-2400390",
    "status": "live",
    "eventId": "cs2-event-9480",
    "eventName": "European Pro League Series 10",
    "eventSlug": "european-pro-league-series-10",
    "eventLogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/90dc6c701150ac12e6fc0ac2ddfc558b.webp",
    "eventImageUrl": null,
    "eventBannerImageUrl": null,
    "event": {
      "eventId": "cs2-event-9480",
      "name": "European Pro League Series 10",
      "slug": "european-pro-league-series-10",
      "logoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/90dc6c701150ac12e6fc0ac2ddfc558b.webp",
      "imageUrl": null,
      "bannerImageUrl": null
    },
    "bestOf": 3,
    "teams": {
      "team1Id": "cs2-team-12889",
      "team1Name": "G2 Ares",
      "team1LogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/9158a57c6e0e020169cc9b45501d3073.webp",
      "team1AlternateLogoUrl": null,
      "team1DarkUiLogoUrl": null,
      "team2Id": "cs2-team-14124",
      "team2Name": "Lunacy",
      "team2LogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/bfbc6dd5ae5abc9b6db84eff3cd5b45a.webp",
      "team2AlternateLogoUrl": null,
      "team2DarkUiLogoUrl": null,
      "team1LogoIsPlaceholder": false,
      "team2LogoIsPlaceholder": false
    },
    "score": {
      "team1": 0,
      "team2": 0
    },
    "currentMapScore": {
      "team1": 13,
      "team2": 6
    },
    "team1Id": "cs2-team-12889",
    "team2Id": "cs2-team-14124",
    "team1Name": "G2 Ares",
    "team2Name": "Lunacy",
    "team1Score": 0,
    "team2Score": 0,
    "currentMap": "de_mirage",
    "currentRound": 19,
    "roundTimeSeconds": null,
    "mapRounds": [
      {
        "mapNumber": 1,
        "mapName": "Mirage",
        "status": "live",
        "team1Score": 13,
        "team2Score": 6,
        "complete": true,
        "missingRounds": [],
        "rounds": [
          {
            "round": 1,
            "winnerSide": "CT",
            "winnerTeamId": "cs2-team-12889",
            "winnerTeamName": "G2 Ares",
            "winReason": "bomb_defused",
            "endedAt": "2026-11-11T11:57:00.279Z"
          },
          {
            "round": 2,
            "winnerSide": "T",
            "winnerTeamId": "cs2-team-14124",
            "winnerTeamName": "Lunacy",
            "winReason": "bomb_exploded",
            "endedAt": "2026-11-11T11:59:38.875Z"
          }
        ]
      }
    ],
    "…": "13 more fields"
  },
  "meta": {
    "dataAvailable": true
  }
}

Live matches

GET/api/v1/cs2/live
GET/api/v1/cs2/matches/live

Matches in progress now. `score` / `team1Score` / `team2Score` are the series (maps won); the map being played is `currentMapScore`. Use a `matchId` with the `/cs2/live/{matchId}/…` endpoints for round-level detail. Each match carries `streams` (count, languages, the official broadcast's embed with `embedUrlTemplate`, and `href` to the full list; null when none): see `/cs2/matches/{matchId}/streams` for the embed rules. **Conditional GET:** the response carries a weak `ETag` that changes only when the data does (not on every poll). Send it back as `If-None-Match` and an unchanged list returns `304 Not Modified` with no body (works from browser `fetch()` too; `Cache-Control: private, no-cache`). The tag is of what your plan receives (delayed plans have their own tags). A 304 is free: it does not count toward your monthly quota and writes no usage row (it still takes one per-minute rate-limit slot). These routes are equivalent; use whichever reads best.

Query parameters

ParameterTypeDescription
bestOfstringOnly matches of this series length: 1, 3 or 5, or a comma list (3,5). bestOf=3 returns BO3 matches only; paging and totals count the filtered rows. Any other value is 400 INVALID_BEST_OF.
includestringOdds are embedded by default for keys with odds access (Pro and above, or the 3-day trial): every row has odds[] (series winner h2h first, then each map, with implied probabilities and market depth: liquidityUsd, volumeUsd, spread), h2hOdds (the match-winner line, or null) and oddsAvailable. Without access rows carry odds: [] and meta.oddsError. include=odds is accepted and changes nothing here. include=player_props adds playerProps[]: the match's open pick'em lines per player and market, every provider side by side with lineSpread (same access as odds).

Example

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

Response

json
{
  "success": true,
  "data": [
    {
      "entityType": "cs2_live_match",
      "id": "cs2-match-2400390",
      "matchId": "cs2-match-2400390",
      "status": "live",
      "eventId": "cs2-event-9480",
      "eventName": "European Pro League Series 10",
      "eventSlug": "european-pro-league-series-10",
      "eventLogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/d8b60b96c9da7fd557053f10db5200d9.webp",
      "eventImageUrl": null,
      "eventBannerImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/69e2017bcff5454a6b3ea8214eda5963.webp",
      "event": {
        "eventId": "cs2-event-9480",
        "name": "European Pro League Series 10",
        "slug": "european-pro-league-series-10",
        "logoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/d8b60b96c9da7fd557053f10db5200d9.webp",
        "imageUrl": null,
        "bannerImageUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/69e2017bcff5454a6b3ea8214eda5963.webp"
      },
      "bestOf": 3,
      "teams": {
        "team1Id": "cs2-team-12889",
        "team1Name": "G2 Ares",
        "team1LogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/9158a57c6e0e020169cc9b45501d3073.webp",
        "team1AlternateLogoUrl": null,
        "team1DarkUiLogoUrl": null,
        "team2Id": "cs2-team-14124",
        "team2Name": "Lunacy",
        "team2LogoUrl": "https://api.citoapi.com/api/v1/public/images/cs2/logos/bfbc6dd5ae5abc9b6db84eff3cd5b45a.webp",
        "team2AlternateLogoUrl": null,
        "team2DarkUiLogoUrl": null,
        "team1LogoIsPlaceholder": false,
        "team2LogoIsPlaceholder": false
      },
      "score": {
        "team1": 0,
        "team2": 0
      },
      "currentMapScore": {
        "team1": 13,
        "team2": 6
      },
      "team1Id": "cs2-team-12889",
      "team2Id": "cs2-team-14124",
      "team1Name": "G2 Ares",
      "team2Name": "Lunacy",
      "team1Score": 0,
      "team2Score": 0,
      "currentMap": "de_mirage",
      "currentRound": 19,
      "roundTimeSeconds": null,
      "odds": [
        {
          "oddsKey": "market:6831152",
          "matchId": "cs2-match-2400390",
          "provider": "prediction_market",
          "market": "h2h",
          "team1Odds": 1.26,
          "team2Odds": 4.88,
          "drawOdds": null,
          "team1ImpliedProb": 0.7937,
          "team2ImpliedProb": 0.2049,
          "liquidityUsd": 6623.0451,
          "volumeUsd": 12177.343706000001,
          "volume24hUsd": 12831.526777,
          "bestBid": 0.78,
          "bestAsk": 0.81,
          "spread": 0.03,
          "marketStatus": "open",
          "capturedAt": "2026-11-11T12:56:46.117Z"
        },
        {
          "oddsKey": "market:6831150",
          "matchId": "cs2-match-2400390",
          "provider": "prediction_market",
          "market": "map_h2h_1",
          "team1Odds": 1.01,
          "team2Odds": 100,
          "drawOdds": null,
          "team1ImpliedProb": 0.9901,
          "team2ImpliedProb": 0.01,
          "liquidityUsd": 2029.0524,
          "volumeUsd": 9781.291927999999,
          "volume24hUsd": 13762.901960000003,
          "bestBid": 0.99,
          "bestAsk": null,
          "spread": null,
          "marketStatus": "suspended",
          "capturedAt": "2026-11-11T12:54:51.046Z"
        }
      ],
      "…": "15 more fields"
    },
    {
      "entityType": "cs2_live_match",
      "id": "cs2-match-2400332",
      "matchId": "cs2-match-2400332",
      "st
…

Try the CS2 Live Scores 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/live" \
  -H "x-api-key: YOUR_API_KEY"
Was this page helpful?