Blizzard Entertainment website screenshot

Blizzard Entertainment

Blizzard Entertainment is an American video game developer and publisher and a subsidiary of Activision Blizzard. Blizzard exposes a Battle.net Developer Portal that provides public OAuth 2.0 protected APIs returning game data and player profile data for its major franchises including World of Warcraft, Diablo III, StarCraft II, and Hearthstone.

Blizzard Entertainment publishes 18 APIs on the APIs.io network, including Achievements API, Acts API, Artisans API, and 15 more. Tagged areas include Games, Entertainment, Video Games, Game Data, and Battle.net.

The Blizzard Entertainment catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Blizzard Entertainment’s developer surface includes authentication, developer portal, documentation, getting-started guide, and 15 more developer resources.

🌐 Visit website 📡 Source on GitHub
51.6/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreeSelf serve⚡ Free to try
18 APIs 6 Features 5 Use Cases
GamesEntertainmentVideo GamesGame DataBattle.net

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 51.6/100 · developing
Contract Quality 16.3 / 25
Developer Ergonomics 7.8 / 20
Commercial Clarity 11.6 / 20
Operational Transparency 4.8 / 13
Governance 3.8 / 12
Discoverability 7.4 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/blizzard-entertainment: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 18

Individual APIs this provider publishes, each with its own machine-readable definition.

Blizzard Entertainment Achievements API

Retrieve achievement reference data.

Blizzard Entertainment Acts API

Retrieve Diablo III act reference data.

Blizzard Entertainment Artisans API

Retrieve artisan and recipe reference data.

Blizzard Entertainment Auctions API

Retrieve live auction-house listings per connected realm.

Blizzard Entertainment Authorization API

User-context authorization endpoints.

Blizzard Entertainment Card Backs API

Retrieve Hearthstone card-back data.

Blizzard Entertainment Cards API

Search and retrieve Hearthstone cards.

Blizzard Entertainment Characters API

Retrieve character class and skill reference data.

Blizzard Entertainment Decks API

Decode Hearthstone deck codes.

Blizzard Entertainment Guilds API

Retrieve guild profile data.

Blizzard Entertainment Items API

Retrieve item type and item reference data.

Blizzard Entertainment Ladders API

Retrieve ladder, grandmaster, and season data.

Blizzard Entertainment Metadata API

Retrieve Hearthstone metadata reference data.

Blizzard Entertainment Mounts API

Retrieve mount index and detail data.

Blizzard Entertainment Profiles API

Retrieve player career and hero profile data.

Blizzard Entertainment Realms API

Retrieve realm and connected-realm reference data.

Blizzard Entertainment Token API

Token issuance and inspection endpoints.

Blizzard Entertainment UserInfo API

OpenID Connect userinfo endpoint.

Scroll for all 18

Open Collections 5

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Diablo III Community API

OPEN COLLECTION

Hearthstone Game Data API

OPEN COLLECTION

Battle.net OAuth API

OPEN COLLECTION

StarCraft II Community API

OPEN COLLECTION

World of Warcraft Game Data API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Blizzard Entertainment Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Blizzard Entertainment Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Blizzard Entertainment Finops

FINOPS

Features 6

Notable capabilities this provider offers.

Multi-Game Coverage

Single platform exposes Game Data and Community APIs for World of Warcraft, Diablo III, StarCraft II, and Hearthstone

OAuth 2.0 Authentication

Client credentials flow for public game data and authorization code flow for player-profile data

Regional API Hosts

Independent regional endpoints for US, EU, KR, TW, and CN with locale-aware responses

Battle.net Account Login

OpenID Connect compatible login that lets third-party apps authenticate Battle.net users

Static and Dynamic Namespaces

Game Data APIs are partitioned by namespace (static-, dynamic-, profile-) to separate patch-stable reference data from live state

Auction House Data

Endpoint exposing live World of Warcraft auction house listings per connected realm

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Blizzard Entertainment Context

38 classes · 9 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Blizzard Entertainment API Rules

5 rules · 2 errors 3 warnings

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Blizzard Entertainment Authentication

http · 1 scheme

SECURITY

Blizzard Entertainment Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Blizzard Entertainment Agentic Access

26 operations · 2 acting

26 operations · 2 acting

AGENTIC

Use Cases 5

What developers build with this provider.

Companion Apps

Build mobile and web companion apps that surface character, guild, ladder, and profile data

Theorycrafting and Stats Sites

Power character optimizer, mythic-plus rank tracker, and deck-tracker sites with first-party data

Esports Tooling

Pull ladder and seasonal data for esports brackets, statistics, and broadcast overlays

Add-on and Mod Ecosystems

Provide authoritative reference data to community add-on libraries and mod managers

Account Linking

Let players authenticate with their Battle.net account in third-party communities and tournament platforms

Integrations 3

Pre-built integrations with other platforms and tools.

Discord

Battle.net account linking is widely combined with Discord OAuth for community gating

Twitch

Companion overlays and stream tools surface live ladder and profile data

Raider.IO

Community service that aggregates WoW profile and mythic-plus data via the Game Data API

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal
Portal
 GettingStarted
GettingStarted

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

SpectralRules
SpectralRules
 Vocabulary
Vocabulary
 JSONLD
JSONLD

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 4

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication
 Authentication
Authentication

Operate 2

Status, limits, changes, and where to get help

Forums
Forums
 RateLimits
RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy
 Plans
Plans
 FinOps
FinOps

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: blizzard-entertainment
url: https://raw.githubusercontent.com/api-evangelist/blizzard-entertainment/refs/heads/main/apis.yml
name: Blizzard Entertainment
type: Index
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/blizzard-entertainment.png
tags:
- Games
- Entertainment
- Video Games
- Game Data
- Battle.net
description: Blizzard Entertainment is an American video game developer and publisher and a subsidiary of Activision Blizzard.
  Blizzard exposes a Battle.net Developer Portal that provides public OAuth 2.0 protected APIs returning game data and player
  profile data for its major franchises including World of Warcraft, Diablo III, StarCraft II, and Hearthstone.
created: '2026-05-05'
modified: '2026-05-19'
specificationVersion: '0.19'
apis:
- aid: blizzard-entertainment:blizzard-entertainment-achievements-api
  name: Blizzard Entertainment Achievements API
  description: Retrieve achievement reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Achievements
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-achievements-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-acts-api
  name: Blizzard Entertainment Acts API
  description: Retrieve Diablo III act reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Acts
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-acts-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-artisans-api
  name: Blizzard Entertainment Artisans API
  description: Retrieve artisan and recipe reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Artisans
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-artisans-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-auctions-api
  name: Blizzard Entertainment Auctions API
  description: Retrieve live auction-house listings per connected realm.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Auctions
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-auctions-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-authorization-api
  name: Blizzard Entertainment Authorization API
  description: User-context authorization endpoints.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Authorization
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-authorization-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-card-backs-api
  name: Blizzard Entertainment Card Backs API
  description: Retrieve Hearthstone card-back data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Card Backs
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-card-backs-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-cards-api
  name: Blizzard Entertainment Cards API
  description: Search and retrieve Hearthstone cards.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Cards
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-cards-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-characters-api
  name: Blizzard Entertainment Characters API
  description: Retrieve character class and skill reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Characters
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-characters-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-decks-api
  name: Blizzard Entertainment Decks API
  description: Decode Hearthstone deck codes.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Decks
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-decks-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-guilds-api
  name: Blizzard Entertainment Guilds API
  description: Retrieve guild profile data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Guilds
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-guilds-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-items-api
  name: Blizzard Entertainment Items API
  description: Retrieve item type and item reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Items
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-items-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-ladders-api
  name: Blizzard Entertainment Ladders API
  description: Retrieve ladder, grandmaster, and season data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Ladders
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-ladders-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-metadata-api
  name: Blizzard Entertainment Metadata API
  description: Retrieve Hearthstone metadata reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Metadata
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-metadata-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-mounts-api
  name: Blizzard Entertainment Mounts API
  description: Retrieve mount index and detail data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Mounts
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-mounts-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-profiles-api
  name: Blizzard Entertainment Profiles API
  description: Retrieve player career and hero profile data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Profiles
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-profiles-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-realms-api
  name: Blizzard Entertainment Realms API
  description: Retrieve realm and connected-realm reference data.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Realms
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-realms-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-token-api
  name: Blizzard Entertainment Token API
  description: Token issuance and inspection endpoints.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - Token
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-token-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
- aid: blizzard-entertainment:blizzard-entertainment-userinfo-api
  name: Blizzard Entertainment UserInfo API
  description: OpenID Connect userinfo endpoint.
  humanURL: https://develop.battle.net/documentation/world-of-warcraft
  baseURL: https://us.api.blizzard.com
  tags:
  - UserInfo
  properties:
  - type: OpenAPI
    url: openapi/blizzard-entertainment-userinfo-api-openapi.yml
  - type: Documentation
    url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis
  - type: Authentication
    url: https://develop.battle.net/documentation/guides/using-oauth
  - type: Documentation
    url: https://develop.battle.net/documentation/diablo-3/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/starcraft-2/community-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/hearthstone/game-data-apis
  - type: Documentation
    url: https://develop.battle.net/documentation/guides/using-oauth
common:
- type: AgenticAccess
  url: agentic-access/blizzard-entertainment-agentic-access.yml
- type: DomainSecurity
  url: security/blizzard-entertainment-domain-security.yml
- type: Authentication
  url: authentication/blizzard-entertainment-authentication.yml
- type: GitHubOrganization
  url: https://github.com/Blizzard
- type: LinkedIn
  url: https://www.linkedin.com/company/blizzard-entertainment
- type: Website
  url: https://www.blizzard.com/
- type: Portal
  url: https://develop.battle.net/
- type: Documentation
  url: https://develop.battle.net/documentation
- type: GettingStarted
  url: https://develop.battle.net/documentation/guides/getting-started
- type: Authentication
  url: https://develop.battle.net/documentation/guides/using-oauth
- type: TermsOfService
  url: https://www.blizzard.com/legal/8b946525-de01-481a-9f4f-89af2c4f5d29/blizzard-end-user-license-agreement
- type: PrivacyPolicy
  url: https://www.blizzard.com/legal/fba4d00f-c7e4-4883-b8b9-1b4500a402ea/blizzard-entertainment-privacy-notice
- type: Forums
  url: https://us.forums.blizzard.com/en/blizzard/c/api-discussion/18
- type: SpectralRules
  url: rules/blizzard-entertainment-rules.yml
- type: Vocabulary
  url: vocabulary/blizzard-entertainment-vocabulary.yaml
- type: JSONLD
  url: json-ld/blizzard-entertainment-context.jsonld
- type: Plans
  url: plans/blizzard-entertainment-plans-pricing.yml
- type: RateLimits
  url: rate-limits/blizzard-entertainment-rate-limits.yml
- type: FinOps
  url: finops/blizzard-entertainment-finops.yml
- type: Features
  data:
  - name: Multi-Game Coverage
    description: Single platform exposes Game Data and Community APIs for World of Warcraft, Diablo III, StarCraft II, and
      Hearthstone
  - name: OAuth 2.0 Authentication
    description: Client credentials flow for public game data and authorization code flow for player-profile data
  - name: Regional API Hosts
    description: Independent regional endpoints for US, EU, KR, TW, and CN with locale-aware responses
  - name: Battle.net Account Login
    description: OpenID Connect compatible login that lets third-party apps authenticate Battle.net users
  - name: Static and Dynamic Namespaces
    description: Game Data APIs are partitioned by namespace (static-, dynamic-, profile-) to separate patch-stable reference
      data from live state
  - name: Auction House Data
    description: Endpoint exposing live World of Warcraft auction house listings per connected realm
- type: UseCases
  data:
  - name: Companion Apps
    description: Build mobile and web companion apps that surface character, guild, ladder, and profile data
  - name: Theorycrafting and Stats Sites
    description: Power character optimizer, mythic-plus rank tracker, and deck-tracker sites with first-party data
  - name: Esports Tooling
    description: Pull ladder and seasonal data for esports brackets, statistics, and broadcast overlays
  - name: Add-on and Mod Ecosystems
    description: Provide authoritative reference data to community add-on libraries and mod managers
  - name: Account Linking
    description: Let players authenticate with their Battle.net account in third-party communities and tournament platforms
- type: Integrations
  data:
  - name: Discord
    description: Battle.net account linking is widely combined with Discord OAuth for community gating
  - name: Twitch
    description: Companion overlays and stream tools surface live ladder and profile data
  - name: Raider.IO
    description: Community service that aggregates WoW profile and mythic-plus data via the Game Data API
- type: Compliance
  data:
  - name: Battle.net API Terms of Use
    description: Public developer access governed by the Battle.net Developer Terms of Use, including rate limits and attribution
      requirements
  - name: COPPA
    description: Battle.net account creation enforces age gating consistent with COPPA in the United States
  - name: GDPR
    description: EU regional endpoints and data handling are governed by Activision Blizzard's GDPR program
position: Provider
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com