Skip to main content

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

Sample Apps

Available Features

Game events status

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

Check here the game events status. OR - easily check the game events status from your app, 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.
battlenet_taggame_infoPlayer's battelnet tagSee notes229.2
goldgoldThe player's gold across all charactersSee notes229.2

battlenet_tag note

Data Example:


gold note

Data Example:




EventEvent DataFired WhenNotesSince GEP Ver.
match_startIn the beginning of each match after selecting your characterSee notes228.0
match_endAt the end of each match and exit to the main menuSee notes228.0
deathWhen the character diesSee notes235.0

match_start note

Data Example:


match_end note

Data Example:


death note

Data Example:



Info Updates

keyCategoryValuesNotesSince GEP Ver.
locationmatch_infoplayer locationSee notes229.1
mapmatch_infoMap name including area id and territory idSee notes229.2

location note

Data Example:

{"feature":"location","category":"match_info","key":"location","value":"{\"x\" : -1001.76,\"y\" : 133.699,\"z\" : 77.6396}"}

map note

Area possible ID and names - See details

Territory possible ID and names - See details

Data Example:

{"feature":"location","category":"match_info","key":"map","value":"{\"area\" : 448837,\"territory\" : 445427}"}


Info Updates

keyCategoryValuesNotesSince GEP Ver.
namecharacterCurrent character nameSee notes229.2
classcharacterCurrent character classSee notes229.2
levelcharacterCurrent character levelSee notes229.3
xpcharacterCurrent character xpSee notes235.0
healthcharacterCurrent character healthSee notes235.0

name note

Data Example:


class note

List of possible values
  • -1 = Invalid
  • 176832 = "Barbarian Male"
  • 232657 = "Barbarian Female"
  • 338122 = "Druid Male"
  • 421560 = "Druid Female"
  • 430081 = "Necromancer Male"
  • 502576 = "Necromancer Female"
  • 486910 = "Rogue Male"
  • 223602 = "Rogue Female"
  • 220940 = "Sorcerer Male"
  • 72908 = "Sorcerer Female"

Data Example:


level note

Data Example:


xp note

Data Example:


health note

Data Example: