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)
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
| Parameter | Type | Description |
|---|---|---|
| matchId | string | Match id. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/stream" \
-H "x-api-key: YOUR_API_KEY"Response
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
Connection details for subscribing to one live match over the live stream.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/socket" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
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
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/scoreboard" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
Round-by-round results so far in a live match: winner, side and how the round ended.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
| limit | integer | Rows to return. Maximum 500; larger values are reduced to 500. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/rounds" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
Kills, bomb plants and defuses, and round ends recorded during a live match.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/events" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
Running per-player stats for a live match.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/player-stats" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
Map list for a live match with per-map score and status.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/maps" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
Timestamped snapshots of a live match (score, round, players) so the match can be replayed over time. Filter with `from` / `to`.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
| from | string | Start of the date range (ISO 8601, UTC). |
| include | string | Filter by include. |
| limit | integer | Rows to return. Maximum 100; larger values are reduced to 100. |
| ranking | string | Ranking to use: omit for Valve Regional Standings, or world for the world ranking filtered to this region. |
| to | string | End of the date range (ISO 8601, UTC). |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/snapshots" \
-H "x-api-key: YOUR_API_KEY"Response
{
"success": true,
"data": [],
"meta": {
"count": 0,
"excludedEmpty": 2,
"dataAvailable": true,
"limit": 0,
"total": 0,
"page": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}Live state
The latest state of one live match: score, round, round timer, bomb status and players.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854/state" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
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
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
| include | string | rounds adds mapRounds: the round history of every map played so far (see below). |
Example
curl "https://api.citoapi.com/api/v1/cs2/live/cs2-match-2399854" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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
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
| Parameter | Type | Description |
|---|---|---|
| bestOf | string | Only 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. |
| include | string | Odds 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
curl "https://api.citoapi.com/api/v1/cs2/live" \
-H "x-api-key: YOUR_API_KEY"Response
{
"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.
curl "https://api.citoapi.com/api/v1/cs2/live" \
-H "x-api-key: YOUR_API_KEY"