Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Battle.net Hearthstone Cards API
version: 1.0.0
description: Hearthstone API from Blizzard Entertainment (Activision Blizzard, part of Microsoft Gaming), converted field-for-field from the machine-readable API reference the Battle.net Community Developer Portal serves at community.developer.battle.net/api/pages/content/documentation/*.json (saved verbatim in openapi/_original/battle-net-reference/). Response schemas are not published in that reference.
contact:
name: Battle.net Community Developer Portal
url: https://community.developer.battle.net/
termsOfService: https://www.blizzard.com/en-us/legal/a2aefd3f-87e1-4a35-a38d-e0f7a8f42a00/blizzard-developer-api-terms-of-use
x-generated-from: provider-reference-json
x-derived-from:
- openapi/_original/battle-net-reference/hearthstone-game-data-apis.json
x-derived: '2026-11-04'
servers:
- url: https://{region}.api.blizzard.com
description: Global regions (documented host format {region}.api.blizzard.com)
variables:
region:
enum:
- us
- eu
- kr
- tw
default: us
security:
- oauth2: []
tags:
- name: Cards
paths:
/hearthstone/cards/:idorslug:
get:
operationId: fetchOneCard
summary: Fetch one card
description: Returns the card with an ID or slug that matches the one you specify. For more information, see the Card Search Guide.
tags:
- Cards
x-source: https://community.developer.battle.net/documentation/hearthstone/game-data-apis
parameters:
- name: :idorslug
in: query
required: true
description: An ID or slug that uniquely identifies a card. You can discover these values by using the `GET /hearthstone/cards` endpoint.
schema:
type: string
default: 52119-arch-villain-rafaam
- name: locale
in: query
required: false
description: The locale to reflect in localized data.
schema:
type: string
default: en_US
- name: gameMode
in: query
required: false
description: A recognized game mode (for example, <strong>battlegrounds</strong> or <strong>constructed</strong>). The default value is constructed. See the <a href='/documentation/hearthstone/guides/game-modes'>Game Modes Guide</a> for more information.
schema:
type: string
responses:
'200':
description: Successful response (response schema not published in the reference).
components:
securitySchemes:
oauth2:
type: oauth2
description: Documented at https://community.developer.battle.net/documentation/guides/using-oauth
flows:
clientCredentials:
tokenUrl: https://oauth.battle.net/token
scopes: {}
authorizationCode:
authorizationUrl: https://oauth.battle.net/authorize
tokenUrl: https://oauth.battle.net/token
scopes:
openid: OpenID Connect
wow.profile: World of Warcraft profile
sc2.profile: StarCraft II profile
d3.profile: Diablo III profile