Edit

Apex Legends

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

Game ID

21566

Sample Apps

• APEX game events sample app

Available Features

• gep_internal
• me
• team
• kill
• damage
• death
• revive
• match_state
• match_info
• inventory
• location
• match_summary
• roster
• rank
• kill_feed

Game event status

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

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

gep_internal

Info Updates

key	Category	Values	Notes	Since GEP Ver.
gep_internal	gep_internal	Local + Public version number	See notes	143.0

gep_internal note

Data Example:

{"feature":"gep_internal","category":"gep_internal","key":"version_info","value":"{"local_version":"143.0.10","public_version":"143.0.10","is_updated":true}"}

me

Info Updates

key	Category	Values	Notes	Since GEP Ver.
name	game_info	Local Player Name		128.0
ultimate_cooldown	me	Ultimate ability cooldown (range between 0-100)		128.0

match_info

Info Updates

key	Category	Values	Notes	Since GEP Ver.
pseudo_match_id	match_info	The current match’s ID code. Example: 0c0ea3df-97ea-4d3a-b1f6-f8e34042251f	This is an Overwolf-generated code, unrelated to Respawn.	130.0

match_state

Info Updates

key	Category	Values	Notes	Since GEP Ver.
match_state	game_info	active/inactive		128.0

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
match_start	null	Match started		128.0
match_end	null	Match ended	See notes	128.0

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.

team

Info Updates

key	Category	Values	Notes	Since GEP Ver.
teammate_X	match_info	This feature provides the list of your squad members.		128.0
legendSelect_X	match_info	The name of the legend & order of selection for every member in the team, including noting who the jump-master is.		128.0
team_info	match_info	The current status of the local player’s team.		128.0

teammate_X notes

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

{"info":{"match_info":{"teammate_0":"{"name":"Sh4rgaas","state":"alive"}"}},"feature":"team"}

As youcan see, this 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:

{"playerName":"fReeeeezeeeee","legendName":"#character_pathfinder_NAME","selectionOrder":"1","lead":false}

team_info notes

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

{"team_state":"active"}

As you can see, this object includes:

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

roster

Info Updates

key	Category	Values	Notes	Since GEP Ver.
roster_XX	match_info	Provides 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:

{"info":{"match_info":{"roster_3":"{"name":"RunLikePistorius","isTeammate":false}"}},"feature":"roster"}

As you can see, this object includes:

• name - Player name
• isTeammate (Bool) - Player is/isn't a squad member

location

Info Updates

key	Category	Values	Notes	Since GEP Ver.
location	match_info	See example below		130.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

Event data example

{"info":{"match_info":{"location":"{"x":"93","y":"305","z":"49"}"}},"feature":"location"}

rank

Info Updates

key	Category	Values	Notes	Since GEP Ver.
victory	match_info	true/false	At the end of the match provides “true” for winning and “false” for losing.	128.0

match_summary

Info Updates

key	Category	Values	Notes	Since GEP Ver.
match_summary	match_info			130.0

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

Event data example

{"feature":"match_summary","category":"match_info","key":"match_summary","value":"{"rank":"12","teams":"20","squadKills":"5"}"}

damage

Info Updates

key	Category	Values	Notes	Since GEP Ver.
totalDamageDealt	me	The total amount of damage inflicted in a match of Apex. See example below.		130.0

totalDamageDealt notes

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.

Event data example

{"feature":"damage","category":"me","key":"totalDamageDealt","value":668}

Events

Event	Event Data	Fired When (announcement)	Notes	Since GEP Ver.
damage	See example below	When the local player deals damage to another player.		130.0

damage notes

The following properties are provided:

• targetName
• damageAmount
• armor
• headshot
• grenade

Event data example

{"targetName": "Fortiziak","damageAmount": "25.000000","armor": "true","headshot": "true"}

inventory

Info Updates

key	Category	Values	Notes	Since GEP Ver.
inventory_XX	me	Lists the items picked up into the local player's inventory (Tab). Example: {"name":"unknown_42","amount":"40"}		130.0
weapons	me	Weapons currently used by the local player - there are two slots available marked 0 and 1. Example: {"weapon0":"Wingman","weapon1":"Alternator SMG"}		0.130
inUse	me	Items currently used by the local player. Example: {"inUse":"Kunai Melee"}		0.130

kill

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill	victimName	Local player killed another player. {"victimName": "6ewehrw0lf"}		130.0
knockdown	victimName	Local player knocked out another player. {"victimName":"J0GUR7"}		130.0
assist	victimName	Local player participated in a team member’s kill. Provided values: 1. victimName 2. type - knockdown / elimination Example: {"victimName":"VioletAlbicocca","type":"knockdown"}		130.0

revive

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
healed_from_ko	null	Local player was revived from knocked out state.		128.0
respawn	null	Local player was returned to the game at a beacon.		128.0

death

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
knocked_out	null	Local player’s health drops to zero.		128.0
death	null (in the future we will provide the killer name).	Local player died during knocked out state.	There is another health bar during knocked out state, it’s orange, above the player name.	128.0

kill_feed

Events

Event	Event Data	Fired When	Notes	Since GEP Ver.
kill_feed	See example below	When information is presented on the game’s UI (top right corner).		130.0

kill_feed notes

The following properties are provided:

• local_player_name
• attackerName
• victimName
• weaponName
• action

Event data example

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