Skip to main content

CS2 Valve GSI

GAME_EVENT/MATCH/END_MAP

This message is sent when the game (current map) ends.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

isMatchOver

boolean, null

Indicates whether with the end of this map one of the teams satisfied the win condition for the match series (e.g. won 2 games in best-of-three match).

mapName

string, null

The name of the map that is being played, e.g. `de_dust2`.

matchCurrent

integer

The current game number in the match series.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

winningTeamUrn

string, null

The reference URN of the winning team, if available.

EXAMPLE

GAME_EVENT/MATCH/END_PAUSE

This message is sent when a pause ends and the game resumes.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

roundNumber

integer

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/END_ROUND

This message is sent when a round ends.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerBalances

array, null

A list of cash balances for all active players.

object

A list of cash balances for all active players.

PROPERTIES

balance

integer

The player's cash balance.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

playerInventories

array, null

A list of inventory items for all active players.

object

A list of inventory items for all active players.

PROPERTIES

equipmentValue

integer

Sum of all item prices, values are based on the best guess of the game version that is being played.

items

array, null

A list of items the player owns.

string

A list of items the player owns.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

roundNumber

integer

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

winReason

The reason the team won the round, e.g. BOMB_DEFUSED, TEAM_ELIMINATION.

winningTeamUrn

string, null

The reference URN of the winning team, if available.

EXAMPLE

GAME_EVENT/MATCH/FREEZE_TIME_ENDED

This message is sent when the freeze time (buy phase) ended.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerBalances

array, null

A list of cash balances for all active players.

object

A list of cash balances for all active players.

PROPERTIES

balance

integer

The player's cash balance.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

playerInventories

array, null

A list of inventory items for all active players.

object

A list of inventory items for all active players.

PROPERTIES

equipmentValue

integer

Sum of all item prices, values are based on the best guess of the game version that is being played.

items

array, null

A list of items the player owns.

string

A list of items the player owns.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/FREEZE_TIME_STARTED

This message is sent when the freeze time (buy phase) started.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerBalances

array, null

A list of cash balances for all active players.

object

A list of cash balances for all active players.

PROPERTIES

balance

integer

The player's cash balance.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

teams

array, null

A list of faction information about all teams for the current round.

object

A list of faction information about all teams for the current round.

PROPERTIES

side

string, null

The side the team plays on, e.g. CT or TERRORIST.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/START_MAP

This message is sent when a game (map) starts.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

mapName

string, null

The name of the map that is being played, e.g. `de_dust2`.

matchCurrent

integer

The current game number in the match series.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/START_PAUSE

This message is sent when the game is paused due to a technical or tactical time out.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

roundNumber

integer

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/START_ROUND

This message is sent when a round starts (after the freeze time).
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

roundNumber

integer

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/DEALT_DAMAGE

This message is sent when a player dealt damage to another player.
Download

PROPERTIES

armor

integer, null

armorDeducted

integer, null

Indicates the amount deducted from the player's armor.

armorRemaining

integer, null

Indicates the amount of armor remaining.

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

health

integer, null

healthDeducted

integer, null

Indicates the amount deducted from the player's health.

healthRemaining

integer, null

Indicates the amount of health remaining.

hitgroup

string, null

The hit zone of the damage, e.g. `head`.

killerTeamUrn

string, null

The reference URN of the damage dealing player's team.

killerUrn

string, null

The reference URN of the damage dealing player.

position

array, null

The ingame coordinates where the event happened.

integer

targetPosition

array, null

The position of the target player.

integer

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

victimTeamUrn

string, null

The reference URN of the damage taking player's team.

victimUrn

string, null

The reference URN of the damage taking player.

weapon

string, null

The weapon used to inflict the damage.

EXAMPLE

GAME_EVENT/PLAYER/DEFUSED_BOMB

This message is sent when a player defused the bomb.
Download

PROPERTIES

balance

integer

The player's new cash balance, including the defuse reward.

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/DIED

This message is sent when a player died.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerUrn

string, null

The player reference URN.

position

array, null

The ingame coordinates where the event happened.

integer

respawnTime

integer

Unused. This field will be removed in a future release.

suicide

boolean

Indicates whether the player killed themselves.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

totalDeaths

integer

Total number of this player's deaths within the current game, including current death.

EXAMPLE

GAME_EVENT/PLAYER/DROPPED_ITEM

This message is sent when a player drops an item.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

item

string, null

The name of the item that the player dropped.

playerUrn

string, null

The player reference URN.

position

array, null

The ingame coordinates where the event happened.

integer

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/KILL

This message is sent when a player kills another player.
Download

PROPERTIES

assistType

Describes only 'damage' assist type for this data source

assistants

array, null

A list of URNs of the players who assisted the kill and got assist reward for it.

string

A list of URNs of the players who assisted the kill and got assist reward for it.

balance

integer

Updated cash balance for the killer, including the kill reward.

blind

boolean, null

The feature is not available for this data source

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

headshot

boolean, null

Indicates whether it was a head shot.

inAir

boolean, null

The feature is not available for this data source

killerTeamUrn

string, null

The reference URN of the killer's team.

killerUrn

string, null

The reference URN of the killer.

noScope

boolean, null

The feature is not available for this data source

penetrated

boolean, null

Indicates whether the bullet penetrated another object first.

position

array, null

The ingame coordinates where the event happened.

integer

throughSmoke

boolean, null

The feature is not available for this data source

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

victimTeamUrn

string, null

The reference URN of the victim's team.

victimUrn

string, null

The reference URN of the victim.

weapon

string, null

The weapon used to inflict the final damage.

EXAMPLE

GAME_EVENT/PLAYER/PICKED_UP_ITEM

This message is sent when an item is added to a player's inventory.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

item

string, null

The name of the item that the player picked up.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/PLANTED_BOMB

This message is sent when a player planted the bomb.
Download

PROPERTIES

balance

integer

The player's new cash balance, including the plant reward.

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/PURCHASED_ITEM

This message is sent when a player purchased an item.
Download

PROPERTIES

balance

integer

The new cash balance value for this player.

currentRoundNumber

integer

The current round number within the game.

equipmentValue

integer

The new total equipment value for this player.

gameTime

integer

The time spent in the current phase, in milliseconds.

item

string, null

The name of the item that the player purchased.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/STARTED_DEFUSING_BOMB

This message is sent when a player starts defusing the bomb.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/THREW_ITEM

This message is sent when an item thrown by a player hits the ground.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

item

string, null

The name of the item that the player threw.

playerUrn

string, null

The player reference URN.

position

array, null

The ingame coordinates where the event happened.

integer

teamUrn

string, null

The team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/UPDATE_SCORE

This message is deprecated and will be removed in future. It is currently sent when player's stats update, such as `kills`, `assists`, `balance`, `deaths`.
Download

PROPERTIES

alive

boolean

Indicates whether the player is currently alive.

assists

integer

The number of assists the player performed during current round.

balance

integer

The player's current cash balance.

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

kills

integer

The number of kills the player performed during current round.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

GAME_EVENT/TEAM/EXPLODED_BOMB

This message is sent when the bomb exploded.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

teamUrn

string, null

The terrorist team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

INFO/MATCH/ANNOUNCE

The first message sent for a game, the team and player information might be incomplete at this point. This message contains fixture information about the teams, the players, and the series.
Download

PROPERTIES

fixture

object, null

Fixture information for this match series.

PROPERTIES

references

object, null

Reference IDs of the fixture in external services.

seriesCurrent

integer

Current game (map) number in the match series.

seriesMax

integer

Maximum number of games (maps) in this match series.

seriesType

Type of the match series, e.g. BEST_OF.

startTime

string, null

UTC date and time when the match started.

title

Game title that is being played, e.g. CSGO, DOTA.

urn

string, null

The fixture reference URN.

teams

array, null

Currently available information about the participating teams and players.

object

Currently available information about the participating teams and players.

PROPERTIES

participants

array, null

List of currently known team participants in this game.

object

List of currently known team participants in this game.

PROPERTIES

name

string, null

The player name.

references

object, null

Reference IDs of the player in external services.

urn

string, null

The player reference URN.

references

object, null

Reference IDs of the team in external services.

urn

string, null

The team reference URN.

EXAMPLE

INFO/MATCH/ROLLBACK

This message is sent when the current round is reset, or the game is reset to a previous round.
Download

PROPERTIES

nextRoundNumber

integer

The number of the round which will start after the reset.

EXAMPLE

INFO/MATCH/UPDATE

Sent when a team, or player is updated or after series related information changes. This message contains fixture information about the teams, the players, and the series.
Download

PROPERTIES

fixture

object, null

Fixture information for this match series.

PROPERTIES

references

object, null

Reference IDs of the fixture in external services.

seriesCurrent

integer

Current game (map) number in the match series.

seriesMax

integer

Maximum number of games (maps) in this match series.

seriesType

Type of the match series, e.g. BEST_OF.

startTime

string, null

UTC date and time when the match started.

title

Game title that is being played, e.g. CSGO, DOTA.

urn

string, null

The fixture reference URN.

teams

array, null

Currently available information about the participating teams and players.

object

Currently available information about the participating teams and players.

PROPERTIES

participants

array, null

List of currently known team participants in this game.

object

List of currently known team participants in this game.

PROPERTIES

name

string, null

The player name.

references

object, null

Reference IDs of the player in external services.

urn

string, null

The player reference URN.

references

object, null

Reference IDs of the team in external services.

urn

string, null

The team reference URN.

EXAMPLE

SNAPSHOT/MATCH/UPDATE

This message is sent periodically (at most once per second). Match update snapshots are potentially rate-limited to 1 every 5 seconds, depending on the contract.
Download

PROPERTIES

bombTimeDurationSeconds

integer

Duration of the bomb timer in seconds.

currentRoundNumber

integer

The number of the currently played round.

currentRoundState

object, null

Information about the current round.

PROPERTIES

bombState

object, null

Information about the current bomb state.

PROPERTIES

defuseStartedAt

string, null

UTC time and date when the last bomb defusing process had started.

defused

boolean

Indicates whether the bomb is defused.

defusedAt

string, null

UTC time and date when the bomb was defused.

defusingPlayerUrn

string, null

The reference URN of the last player who started defusing the bomb.

planted

boolean

Indicates whether the bomb is planted.

plantedAt

string, null

UTC time and date when the bomb was planted.

plantingPlayerUrn

string, null

The reference URN of the player who planted the bomb.

endTime

string, null

UTC time and date when the round ended (only for finished rounds).

gameTime

integer

Time passed since the start of the round in milliseconds.

playerStates

object, null

Information about the players of the current game.

roundNumber

integer

The current round number within the game.

startTime

string, null

UTC time and date when the round started.

state

Current round phase, e.g. IN PROGRESS, FINISHED.

teamOne

object, null

Information about the first team of the current game.

PROPERTIES

side

string, null

The side the team plays on, e.g. CT or TERRORIST.

teamTwo

object, null

Information about the second team of the current game.

PROPERTIES

side

string, null

The side the team plays on, e.g. CT or TERRORIST.

timeRemaining

integer

Time left in milliseconds until the round time limit is reached.

winReason

The reason a team won the round, e.g. BOMB_DEFUSED, TEAM_ELIMINATION (only for finished rounds).

winningTeamUrn

string, null

Reference URN of the winning team (only for finished rounds).

endTime

string, null

UTC time and date when the game (map) ended (only for finished games).

freezeTimeDurationSeconds

integer

Duration of the freeze time in the beginning of each round in seconds.

gameEnded

boolean

Indicates whether the current game has finished.

lastUpdateTime

string, null

map

string, null

Current map name.

matchStatus

string, null

Status of the current map, e.g. live, finished.

maxRoundsDefault

integer

Maximum number of regular game rounds in the game.

maxRoundsOvertime

integer

Maximum number of rounds in each overtime phase.

previousRoundStates

array, null

List of objects holding information about previous rounds.

object

List of objects holding information about previous rounds.

PROPERTIES

bombState

object, null

Information about the current bomb state.

PROPERTIES

defuseStartedAt

string, null

UTC time and date when the last bomb defusing process had started.

defused

boolean

Indicates whether the bomb is defused.

defusedAt

string, null

UTC time and date when the bomb was defused.

defusingPlayerUrn

string, null

The reference URN of the last player who started defusing the bomb.

planted

boolean

Indicates whether the bomb is planted.

plantedAt

string, null

UTC time and date when the bomb was planted.

plantingPlayerUrn

string, null

The reference URN of the player who planted the bomb.

endTime

string, null

UTC time and date when the round ended (only for finished rounds).

gameTime

integer

Time passed since the start of the round in milliseconds.

playerStates

object, null

Information about the players of the current game.

roundNumber

integer

The current round number within the game.

startTime

string, null

UTC time and date when the round started.

state

Current round phase, e.g. IN PROGRESS, FINISHED.

teamOne

object, null

Information about the first team of the current game.

PROPERTIES

side

string, null

The side the team plays on, e.g. CT or TERRORIST.

teamTwo

object, null

Information about the second team of the current game.

PROPERTIES

side

string, null

The side the team plays on, e.g. CT or TERRORIST.

timeRemaining

integer

Time left in milliseconds until the round time limit is reached.

winReason

The reason a team won the round, e.g. BOMB_DEFUSED, TEAM_ELIMINATION (only for finished rounds).

winningTeamUrn

string, null

Reference URN of the winning team (only for finished rounds).

roundTimeDurationSeconds

integer

Duration of each round in seconds.

sequenceIndex

integer

This message order number.

seriesStatus

object, null

Information about the current match series.

PROPERTIES

perid

string, null

seriesCurrent

integer

Current map number in the match series.

seriesMax

integer

Maximum number of maps in this match series.

seriesScores

object, null

Total team scores in this match series.

seriesType

Type of the match series, e.g. BEST_OF.

startTime

string, null

UTC time and date when the game (map) started.

teamOne

object, null

Information about the first team of the current round.

PROPERTIES

liveDataUrn

string, null

The team reference URN.

name

string, null

The team name.

players

array, null

List of team players.

object

List of team players.

PROPERTIES

assists

integer

Number of assists the player performed during this game.

chickenKills

integer, null

Number of chicken kills the player performed during the game.

deaths

integer

Number of times the player died during the game.

enemyDamageDealtArmor

integer

Total amount of armor the player deducted from the enemy team players during the game.

enemyDamageDealtArmorRaw

integer

Total amount of armor damage (including overkill) the player dealt to the enemy team players during the game.

enemyDamageDealtHealth

integer

Total amount of health the player deducted from the enemy team players during the game.

enemyDamageDealtHealthRaw

integer

Total amount of health damage (including overkill) the player dealt to the enemy team players during the game.

enemyKills

integer

Number of enemy kills the player performed during the game.

friendlyDamageDealtArmor

integer

Total amount of armor the player deducted from other players of the same team during the game.

friendlyDamageDealtHealth

integer

Total amount of health the player deducted from other players of the same team during the game.

friendlyKills

integer

Number of friendly kills the player performed during the game.

headshots

integer

Number of headshots the player performed during this game.

kills

integer

Total number of kills the player performed during the game.

liveDataUrn

string, null

The player reference URN.

name

string, null

The player name.

references

object, null

Reference IDs of the player in external services.

selfKills

integer

Number of self kills the player performed during the game.

references

object, null

Reference IDs of the team in external services.

score

integer

Team score in the current match.

teamTwo

object, null

Information about the second team of the current round.

PROPERTIES

liveDataUrn

string, null

The team reference URN.

name

string, null

The team name.

players

array, null

List of team players.

object

List of team players.

PROPERTIES

assists

integer

Number of assists the player performed during this game.

chickenKills

integer, null

Number of chicken kills the player performed during the game.

deaths

integer

Number of times the player died during the game.

enemyDamageDealtArmor

integer

Total amount of armor the player deducted from the enemy team players during the game.

enemyDamageDealtArmorRaw

integer

Total amount of armor damage (including overkill) the player dealt to the enemy team players during the game.

enemyDamageDealtHealth

integer

Total amount of health the player deducted from the enemy team players during the game.

enemyDamageDealtHealthRaw

integer

Total amount of health damage (including overkill) the player dealt to the enemy team players during the game.

enemyKills

integer

Number of enemy kills the player performed during the game.

friendlyDamageDealtArmor

integer

Total amount of armor the player deducted from other players of the same team during the game.

friendlyDamageDealtHealth

integer

Total amount of health the player deducted from other players of the same team during the game.

friendlyKills

integer

Number of friendly kills the player performed during the game.

headshots

integer

Number of headshots the player performed during this game.

kills

integer

Total number of kills the player performed during the game.

liveDataUrn

string, null

The player reference URN.

name

string, null

The player name.

references

object, null

Reference IDs of the player in external services.

selfKills

integer

Number of self kills the player performed during the game.

references

object, null

Reference IDs of the team in external services.

score

integer

Team score in the current match.

EXAMPLE

SNAPSHOT/PLAYER/UPDATE_POSITIONS

This message is sent periodically.
Download

PROPERTIES

currentRoundNumber

integer

The current round number within the game.

gameTime

integer

The time spent in the current phase, in milliseconds.

positions

array, null

A list of consequent player position changes since the last message. Each sub-list contains a full update for all players. The last sublist is the most recent.

array

A list of consequent player position changes since the last message. Each sub-list contains a full update for all players. The last sublist is the most recent.

object

PROPERTIES

playerUrn

string, null

The player reference URN.

position

array, null

The ingame coordinates of the player's position.

integer

teamUrn

string, null

The player's team reference URN.

timeRemaining

integer

The time remaining on the clock until the current phase (freeze-time or round) ends, in milliseconds.

EXAMPLE

CsgoMessagePayload

PROPERTIES

EXAMPLE