Activision Blizzard

activision-blizzard Hearthstone API

Hearthstone game data APIs

Documentation GitHub OpenAPI

Operations 3

GET /hearthstone/cards Activision Blizzard Get Hearthstone Cards #

GET /hearthstone/cards/{idOrSlug} Activision Blizzard Get Hearthstone Card #

GET /hearthstone/decks Activision Blizzard Get Hearthstone Deck #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/activision-blizzard-hearthstone-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Activision Blizzard Battle.net Account Hearthstone API
  version: 1.0.0
  description: Battle.net Game Data and Profile APIs from Activision Blizzard providing access to data from World of Warcraft, Diablo III, Hearthstone, StarCraft II, Overwatch, and account profile information. Requires OAuth2 client credentials.
  contact:
    name: Blizzard Developer Portal
    url: https://develop.battle.net/
  x-generated-from: documentation
servers:
- url: https://{region}.api.blizzard.com
  description: Battle.net regional API
  variables:
    region:
      enum:
      - us
      - eu
      - kr
      - tw
      default: us
      description: API region
- url: https://gateway.battlenet.com.cn
  description: Battle.net China API
security:
- OAuth2ClientCredentials: []
tags:
- name: Hearthstone
  description: Hearthstone game data APIs
paths:
  /hearthstone/cards:
    get:
      operationId: getHearthstoneCards
      summary: Activision Blizzard Get Hearthstone Cards
      description: Returns an up-to-date list of all cards matching the search criteria
      tags:
      - Hearthstone
      parameters:
      - name: locale
        in: query
        schema:
          type: string
        description: Response locale
      - name: set
        in: query
        schema:
          type: string
        description: Filter cards by set
      - name: class
        in: query
        schema:
          type: string
        description: Filter cards by class
      - name: manaCost
        in: query
        schema:
          type: integer
        description: Filter by mana cost
      - name: attack
        in: query
        schema:
          type: integer
        description: Filter by attack
      - name: health
        in: query
        schema:
          type: integer
        description: Filter by health
      - name: rarity
        in: query
        schema:
          type: string
        description: Filter by rarity
      - name: type
        in: query
        schema:
          type: string
        description: Filter by card type
      - name: page
        in: query
        schema:
          type: integer
        description: Page number
      - name: pageSize
        in: query
        schema:
          type: integer
        description: Cards per page
      responses:
        '200':
          description: Hearthstone cards
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HearthstoneCardsResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /hearthstone/cards/{idOrSlug}:
    get:
      operationId: getHearthstoneCard
      summary: Activision Blizzard Get Hearthstone Card
      description: Returns the card with an ID or slug that matches the one you specify
      tags:
      - Hearthstone
      parameters:
      - name: idOrSlug
        in: path
        required: true
        schema:
          type: string
        description: The card ID or slug
      - name: locale
        in: query
        schema:
          type: string
        description: Response locale
      responses:
        '200':
          description: Card details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HearthstoneCard'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /hearthstone/decks:
    get:
      operationId: getHearthstoneDeck
      summary: Activision Blizzard Get Hearthstone Deck
      description: Finds a deck by its deck code
      tags:
      - Hearthstone
      parameters:
      - name: code
        in: query
        required: true
        schema:
          type: string
        description: A deck code
      - name: locale
        in: query
        schema:
          type: string
        description: Response locale
      responses:
        '200':
          description: Deck details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HearthstoneDeck'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    HearthstoneCard:
      type: object
      description: A Hearthstone card
      properties:
        id:
          type: integer
          description: Card ID
          example: 1234
        collectible:
          type: integer
          description: Whether the card is collectible (1=yes)
          example: 1
        slug:
          type: string
          description: Card slug
          example: ragnaros-the-firelord
        classId:
          type: integer
          description: Class ID
          example: 1
        multiClassIds:
          type: array
          items:
            type: integer
          description: Multi-class IDs
        cardTypeId:
          type: integer
          description: Card type ID
          example: 4
        cardSetId:
          type: integer
          description: Card set ID
          example: 2
        rarityId:
          type: integer
          description: Rarity ID
          example: 5
        artistName:
          type: string
          description: Artist name
          example: Alex Horley
        health:
          type: integer
          description: Card health
          example: 8
        attack:
          type: integer
          description: Card attack
          example: 8
        manaCost:
          type: integer
          description: Mana cost
          example: 8
        name:
          type: string
          description: Card name
          example: Ragnaros the Firelord
        text:
          type: string
          description: Card text
        image:
          type: string
          format: uri
          description: Card image URL
        imageGold:
          type: string
          format: uri
          description: Gold card image URL
        flavorText:
          type: string
          description: Card flavor text
        cropImage:
          type: string
          format: uri
          description: Cropped card image URL
    HearthstoneDeck:
      type: object
      description: A Hearthstone deck
      properties:
        deckCode:
          type: string
          description: The deck code
          example: AAECAQcG0LQDubQD3rUD57UDibYDvbYDDI...
        version:
          type: integer
          description: Deck format version
          example: 1
        format:
          type: object
          description: Deck format
        hero:
          $ref: '#/components/schemas/HearthstoneCard'
        heroPower:
          $ref: '#/components/schemas/HearthstoneCard'
        class:
          type: object
          description: Deck class
        cards:
          type: array
          items:
            $ref: '#/components/schemas/HearthstoneCard'
          description: Cards in the deck
        cardCount:
          type: integer
          description: Number of cards in the deck
          example: 30
    HearthstoneCardsResponse:
      type: object
      description: Paginated Hearthstone cards response
      properties:
        cards:
          type: array
          items:
            $ref: '#/components/schemas/HearthstoneCard'
          description: List of cards
        cardCount:
          type: integer
          description: Total card count
          example: 2847
        pageCount:
          type: integer
          description: Total page count
          example: 143
        page:
          type: integer
          description: Current page
          example: 1
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://oauth.battle.net/token
          scopes:
            wow.profile: Access WoW character profile data
            sc2.profile: Access StarCraft II profile data
            openid: Access basic account information
        authorizationCode:
          authorizationUrl: https://oauth.battle.net/authorize
          tokenUrl: https://oauth.battle.net/token
          scopes:
            wow.profile: Access WoW character profile data
            sc2.profile: Access StarCraft II profile data
            openid: Access basic account information
      description: OAuth2 authentication. Create a client at develop.battle.net for client ID and secret.