Namespaces

Namespaces are a core concept of the Game Data / Profile APIs that allow for documents to be published contextually in relation to a specific patch or point in time. For a more in-depth explanation of namespaces, you can check the Game Data APIs overview page.

The World of Warcraft APIs have established three core categories of document namespace, detailed below.

Category Description
Static The static category of namespaces contain documents which contain data which is not expected to change often and is directly related to underlying game data or game systems. An example of a static resource is a document which details a specific Mythic Keystone Affix or a document which details a specific raid boss.

*Namespaces in this category are expected to change on a per patch basis, though they could change more or less frequently.
Dynamic The dynamic category of namespaces contain documents which are expected to change frequently and are not published at an intentional point in time and are instead published in response to in game events as they happen, such as the completion of a Mythic Keystone Dungeon. This category of namespaces will contain data such as leaderboards, or Wow Token data, which is data that would be expected to update in a frequent and fluid manner.

*Namespaces in this category are expected to change on a per patch basis, though they could change more or less frequently.
Profile The profile category of namespaces contain documents which are contextual to a specific character or Blizzard account. These documents would be expected to change the most frequently as they will update upon character logout, much like the current World of Warcraft Community APIs. An example of documents contained in this category of namespace would include a document that lists all of the World of Warcraft characters that belong to a specific Blizzard account, or the current raid progression history for a specific World of Warcraft character.

*Namespaces in this category are expected to change infrequently, if ever.

Namespace Regionality

The namespaces employed by the World of Waracraft documents in the Game Data APIs willl normally contain a region specific specifier such as us, eu, etc. This region specifier will be appended to the end of the namespace, as depicted in the examples below.

Region Namespace Example
US dynamic-us https://us.api.battle.net/data/wow/token/?namespace=dynamic-us
EU dynamic-eu https://eu.api.battle.net/data/wow/token/?namespace=dynamic-eu
KR dynamic-kr https://kr.api.battle.net/data/wow/token/?namespace=dynamic-kr
TW dynamic-tw https://tw.api.battle.net/data/wow/token/?namespace=dynamic-tw

Current Namespaces

The best way to stay up to date on the current namespaces in use by World of Warcraft is to reference the interactive API Docs page by selecting World of Warcraft Game Data APIs from the dropdown, though as we evolve this documentation and continue to evolve this API, we will be evaluating how to best keep consumers up to date on namespace changes.