Battle.net · OAuth Scopes

Battle.net OAuth Scopes

OAuth 2.0 searched

Battle.net publishes 4 OAuth 2.0 scopes via the clientCredentials flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Battle.net API on a user’s behalf.

Tokens are issued from https://oauth.battle.net/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

GamesGamingBlizzardWorld Of WarcraftDiabloHearthstoneStarcraft

Scopes: 4 Flows: clientCredentials Method: searched

OAuth endpoints

Token URL
https://oauth.battle.net/token

Flows
clientCredentials

Scopes (4)

Scope	Description	Flows
wow.profile	Access to a user's World of Warcraft characters.
sc2.profile	Access to a user's StarCraft II profile.
d3.profile	Access to a user's Diablo III profile.
openid	Access details about a currently logged in user using OpenID Connect (OIDC).

📄 Provider scope reference: https://community.developer.battle.net/documentation/guides/using-oauth

Source

OAuth Scopes

generated: '2026-07-11'
method: searched
source: openapi/battle-net-hearthstone-game-data.yaml
docs: https://community.developer.battle.net/documentation/guides/using-oauth
schemes:
- name: oauth2
  source: openapi/battle-net-hearthstone-game-data.yaml
  flows:
  - flow: clientCredentials
    tokenUrl: https://oauth.battle.net/token
  description: Battle.net OAuth 2.0 authentication. Use client credentials flow for game data
    APIs.
scopes:
- scope: wow.profile
  description: Access to a user's World of Warcraft characters.
  sources:
  - https://community.developer.battle.net/documentation/guides/using-oauth
- scope: sc2.profile
  description: Access to a user's StarCraft II profile.
  sources:
  - https://community.developer.battle.net/documentation/guides/using-oauth
- scope: d3.profile
  description: Access to a user's Diablo III profile.
  sources:
  - https://community.developer.battle.net/documentation/guides/using-oauth
- scope: openid
  description: Access details about a currently logged in user using OpenID Connect (OIDC).
  sources:
  - https://community.developer.battle.net/documentation/guides/using-oauth