Skip to main content

Please read the documentation page to learn how to use Overwolf game events.

Sample Apps

Available Features

Game event status

It is highly recommended to communicate errors and warnings to app users.

Check the current game event status here. Alternatively, you can easily check that status from your app itself, using our API.


Info Updates

keyCategoryValuesNotesSince GEP Ver.
gep_internalgep_internalLocal + Public version numberSee notes143.0

gep_internal note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
namegame_infoLocal Player NameSee notes128.0
ultimate_cooldownmeUltimate ability cooldown (range between 0-100)See notes128.0

name note


"player" info will soon replace "name" info.

Data Example:


ultimate_cooldown note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
languagegame_infoCurent played languageSee notes114.0

language note

Possible values:

  • english - English
  • french - French
  • german - German
  • italian - Italian
  • japanese - Japanese
  • korean - Korean
  • polish - Polish
  • portuguese - Portuguese
  • russian - Russian
  • schinese - Simplified Chinese
  • spanish - Spanish
  • mspanish - Latin American Spanish
  • tchinese - Traditional Chinese

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
playergame_infoName of the local player in the lobby and in a matchSee notes221.1.0
phasegame_infoThe current phase during the gameList of values See notes215.0

player note

If the local player has special characters in their name the game will display these characters as □ everywhere in the UI except for the lobby.

player_name - local player name as displayed in the lobby

in_game_player_name - local player name as displayed inside a match, this parameter will update once the player enters a match.

Data Example:

{"info":{"game_info":{"player":"{\"player_name\": \"~JacksAtWork~\", \"in_game_player_name\": \"□JacksAtWork□\"}"}},"feature":"game_info"}

phase note

Possible values:

Battle Royale -

  • "lobby"
  • "loading_screen"
  • "legend_selection"
  • "aircraft"
  • "freefly"
  • "landed"
  • "match_summary"

Arena -

  • "lobby"
  • "loading_screen"
  • "legend_selection"
  • "shopping"
  • "combat"

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
pseudo_match_idmatch_infoThe current match’s ID code.


This is an Overwolf-generated code, unrelated to Respawn.130.0
game_modematch_infoThe currently selected game mode.See notes158.0
tabsmatch_infoThe current amount of squads, players, cash, and kills of the match (about local player).See notes158.0
map_idmatch_infoThe current played map Id.See notes215.0
arena_scorematch_infoThe current match score.See notes215.0
mode_namematch_infoThe current mode name.See notes241.0
map_namematch_infoThe current map name.See notes241.0

game_mode note

Data Example:


Possible values:

  • "PL_FIRINGRANGE": "Firing Range",
  • "PL_TRAINING": "Training",
  • "PL_DUO": "Duo",
  • "PL_TRIO": "Trio",
  • "PL_Ranked_Leagues": "Ranked",
  • "TDM_NAME": "Team Deathmatch",
  • "CONTROL_NAME": "Control",
  • "GAME_MODE_GUNGAME": "Gun Run",
  • "GAMEMODE_ARENAS": "Arenas",
  • "GAMEMODE_ARENAS_RANKED": "Ranked Arenas",
  • "SHADOWROYALE_MODE": "Shadow Royale"
  • "SURVIVAL_HARDCORE": "Hardcore Royale"
  • "SURVIVAL_HEATWAVE": "Heatwave"

Note that we get these values from the game, so they might be changed from season to season.

tabs note

Data Example:


map_id note

Possible values:

  • "mp_rr_canyonlands_staging_mu1" - King canyon (Training)
  • "mp_rr_canyonlands_hu" - King canyon
  • "mp_rr_tropic_island_mu2" - Storm point
  • "mp_rr_desertlands_mu3" - World's edge
  • "mp_rr_olympus_mu2" - Olympus
  • "mp_rr_divided_moon" - Broken Moon
  • "mp_rr_freedm_skulltown" - Skull Town
  • "mp_rr_arena_habitat" - Habitat 4
  • "mp_rr_aqueduct" - Overflow
  • "mp_rr_party_crasher" - Party crasher
  • "mp_rr_arena_phase_runner" - Phase runner
  • "mp_rr_arena_composite" - Drop off
  • "mp_rr_arena_skygarden " - Encore

Data Example:


arena_score note

Data Example:


mode_name note

Possible values:

  • Firing Range
  • Training
  • Duo
  • Trio
  • Ranked
  • Arenas
  • Ranked Arenas
  • Shadow Royale
  • Hardcore Royale
  • Team Deathmatch
  • Gun Run
  • Control
  • Heatwave
  • Tournament
  • Deadeye
  • Armed and Dangerous
  • Living Shell Trio
  • Tricks N' Treats Trios
  • Three Strikes
  • Revenant Uprisin

Data Example:


map_name note

Possible values:

  • King Canyon
  • Kings Canyon
  • Storm Point
  • World's Edge
  • Olympus
  • Broken Moon
  • Habitat 4
  • Overflow
  • Party Crasher
  • Phase Runner
  • Drop off
  • Encore
  • Lobby

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
match_stategame_infoactive/inactiveSee notes128.0


EventEvent DataFired WhenNotesSince GEP Ver.
match_startnullMatch startedSee notes128.0
match_endnullMatch endedSee notes128.0
round_startnullRound startedSee notes215.0
round_endnullRound endedSee notes215.0

match_state note

Data Example:


match_start note

Data Example:


match_end note

Currently, we have a special case where if someone in your team got a yellow knockdown shield (the one that allows you to self-revive), and your entire team was knocked out, the match end will still fire despite no one reaching a death-state. This is a very rare case that does not commonly happen in the game, however, we're still working on fixing it.

round_start note

Data Example:


round_end note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
teammate_Xmatch_infoThis feature provides the list of your squad members.See notes128.0
legendSelect_Xmatch_infoThe name of the legend & order of selection for every member of the team, including noting who the jump-master and local player are.See notes128.0
team_infomatch_infoThe current status of the local player’s team.See notes128.0

teammate_X notes

Each squad member joining the game will be reported in the following way:


'teammate_X' object includes:

  • player – Player name
  • state – alive/death/knocked out

legendSelect_X notes

Every team member, including the jump-master, will be reported in the following way:


team_info notes

The current status of the local player’s team ("active" or "eliminated").


The 'team_info' object includes:

  • Selection order
  • Legend name
  • Jumpmaster - Bool True/False


Info Updates

keyCategoryValuesNotesSince GEP Ver.
roster_XXmatch_infoProvides the entire list of players in a match (~60 players).128.0

roster_XX notes

Each player joining the game will be reported in the following way:


'roster_XX' object includes:

  • name - Player name
  • isTeammate (Bool) - Player is/isn't a squad member
  • team_id - Numerical value for each squad in-game.
  • platform_hw / platform_sw - The platform which the player plays on currently.
  • state - the current state of the player - alive / knocked_out / death.
  • is_local - where 1 is the local player else 0.
  • platform_id - The player ID in the current used platform.
  • origin_id - The player origin / EA ID.

Possible platform values:

  • "platform_hw":2,"platform_sw":2 = PC/Origin/EA App
  • "platform_hw":2,"platform_sw":7 = PC/Steam
  • "platform_hw":1,"platform_sw":1 = PS4 / PS5
  • "platform_hw":9,"platform_sw":9 = OG Switch
  • "platform_hw":0,"platform_sw":0 = Xbox one X


Info Updates

keyCategoryValuesNotesSince GEP Ver.
locationmatch_infoThe coordinates of the location for the local playerSee notes130.0

location notes

  • Map Center is (0,0,z)
  • King's Canyon appears to be 1x1km
  • Location is polled up to two times in 1 second
  • Location is accurate to a 1-meter resolution, do not use fractions of meters

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
victorymatch_infotrue/falseTriggers at the end of each round. Value “true” for winning and “false” for losing.128.0

victory note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.

match_summary notes

After a match, this will return:

  • The final position the squad has reached (ranked 1-20)
  • Total number of teams in the match
  • Total number of kills made by the squad

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
totalDamageDealtmeThe total amount of damage inflicted in a match of Apex. See the example below.See notes130.0
team_damage_dealtdamageThe total amount of damage inflicted by each team mate in the local player's team.See notes255.0

totalDamageDealt note

Note that the game does not count damage that is inflicted on Armor, only Health damage after the armor was broken. However, our damage report includes damage done to armor, so it will always be higher than the in-game damage.

Data Example:

{"feature": "damage", "category": "me", "key": "totalDamageDealt", "data": "120"}

team_damage_dealt note

Data Example:

{"feature": "damage", "category": "damage", "key": "team_damage_dealt", "data": "[{\"player_name\":\"BigApexGuy\",\"damage_dealt\":\"869\"},{\"player_name\":\"MrTesting\",\"damage_dealt\":\"825\"},{\"player_name\":\"TheOne31\",\"damage_dealt\":\"1083\"}]"}


EventEvent DataFired When (announcement)NotesSince GEP Ver.
damageSee example belowWhen the local player deals damage to another player.130.0

damage notes

The following properties are provided:

  • targetName
  • damageAmount
  • armor
  • headshot
  • grenade

Data Example:

{"events":[{"name":"damage","data":"{\r\n  \"targetName\": \"TMW_JayJay\",\r\n  \"damageAmount\": \"15.000000\",\r\n  \"armor\": \"true\",\r\n  \"headshot\": \"false\"\r\n}"}]}


Info Updates

keyCategoryValuesNotesSince GEP Ver.
inventory_XXmeLists the items picked up into the local player's inventory (Tab).
weaponsmeWeapons currently used by the local player - there are two slots available marked 0 and 1.
{"weapon0":"Wingman","weapon1":"Alternator SMG"}
inUsemeItems currently used by the local player.
{"inUse":"Kunai Melee"}

weapons note

Data Example:

List of available weapons
  • Hemlok Burst AR
  • VK-47 Flatline
  • R-301 Carbine
  • L-Star
  • Devotion
  • M600 Spitfire
  • Wingman
  • RE-45 Auto
  • P2020
  • EVA-8 Auto
  • Peacekeeper
  • Mozambique Shotgun
  • Mastiff Shotgun
  • Prowler Burst PDW
  • R-99
  • Alternator SMG
  • Volt SMG
  • Triple Take
  • Longbow DMR
  • G7 Scout
  • Sentinel
  • Charge Rifle
  • Kraber .50-cal Sniper
  • Thermite Grenade
  • Frag Grenade
  • Arc Star
  • Health Drone
  • Care Package
  • Dome of Protection
  • Defensive Bombardment
  • Grappling Hook
  • Zipline Gun
  • Launch Pad
  • Into the Void
  • Dimensional Rift
  • Smoke Launcher
  • Rolling Thunder
  • Nox Gas Trap
  • Nox Gas Grenade
  • Melee
  • Kunai Melee
  • Health/Shield
  • Knockdown Shield
  • Empty Handed
  • Rampage LMG
  • Bocek Compound Bow
  • 30-30 Repeater
  • C.A.R. SMG
  • Nemesis
  • Wingman
  • Prowler Burst PDW

inUse note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
killtotal killsLocal player killed another player.130.0
knockdownnullLocal player knocked out another player.130.0
assisttotal assistsLocal player participated in a team member’s kill.130.0

kill note

The data includes the local player's total amount of kills

Data Example:


knockdown note

Data Example:


assist note

The data includes the local player's total amount of assists

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
healed_from_konullLocal player was revived from knocked out state.See notes128.0
respawnnullLocal player was returned to the game at a beacon.See notes128.0

healed_from_ko note

Data Example:


respawn note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
knocked_outnullLocal player’s health drops to zero.See notes128.0
deathnullLocal player died during knocked out state.There is another health bar during the knocked out
state, it’s orange, above the player name. See notes

knocked_out note

Data Example:


death note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
kill_feedSee example belowWhen information is presented on the game’s UI (top right corner).130.0

kill_feed notes


To recive the kill_feed event "Obituaries" must be set to "On" in the game's settings

The following properties are provided:

  • local_player_name
  • attackerName
  • victimName
  • weaponName
  • action

Action possible values:

  • kill
  • headshot_kill
  • knockdown
  • Bleed_out
  • Finisher
  • Melee
  • Smoke Launcher
  • Creeping Barrage
  • Caustic Gas
  • Kunai Melee
  • Perimeter Security
  • Defensive Bombardment
  • Knuckle Cluster
  • Piercing Spikes
  • Hope's Dusk Melee
  • Butterfly Knife Melee

Data Example:

{"events":[{"name":"kill_feed","data":"{"local_player_name":"Shargaas","attackerName":"shayan3200", "victimName":"i999n","weaponName":"alternator","action":"knockdown"}"}]}

"Bleed Out" note

The weaponName can return with a "Bleed Out" value. For example:

"events": [{
"name": "kill_feed",
"data": {
"attackerName": "Red_Wizard19TTV",
"victimName": "SoSochek_1337",
"weaponName": "Bleed Out",
"action": "Bleed Out"

"Bleed Out" is when something "external" kills you, which is not an enemy player.
For example, if you are knocked out already, and you are outside of the safe zone, your HP automatically depletes, and when it reaches zero, and you die, you will Bleed Out, and the weaponName and action will return with the "Bleed Out" value. The same rules apply for the "Caustic" legend gas barrels; if they kill you, you also receive a "Bleed Out."