JSON files for Hearthstone

A HearthSim project

The API is available at api.hearthstonejson.com/v1/

The files are all in JSON format, encoded in UTF-8 and categorized by build, then by locale.

The /v1/latest/ endpoint redirects (302) to whichever build is the latest one.

All files are automatically converted from the game files, made available in the hs-data repository.



The game files have greatly changed for the Gadgetzan patch. Some of the data may have changed in unexpected ways.

  • New property: multiClassGroup. Currently, this can be GRIMY_GOONS, JADE_LOTUS or KABAL.
  • New property: classes. This is a list of classes, which is only included when the card is available for multiple classes. Note that the playerClass is usually NEUTRAL for multi-class cards.
  • New property: collectionText. Some cards, most notably Jade Golem cards, have multiple card texts: A generic one (for the collection) and a formatted version, with {} placeholders. The collectionText property is the generic version of the description.
  • The textInPlay property is no longer supported as it is no longer used.

Changes since legacy API

  • Website:
    • New website style and theme!
    • API now has its own subdomain and is served with HTTPS
    • API is now versioned (/v1/)
    • Separate output for each build. /v1/latest/ will always give you the latest build.
    • Locales are now generated into their own directory
    • Zip support has been removed in favour of server compression
  • Cards:
    • CardSet separation has been removed as it was largely unused
    • Tags are not localized anymore (mostly this just means uppercased)
    • Created separate “collectible” set
    • Added individual set and targetingArrowText properties
    • Added some more mechanics (forgetful, treasure…)
    • Added entourage property
    • Added playRequirements property
    • Added `dust property
  • Card backs:
    • Added more properties from the DBF

Card objects

See full card documentation.

Example card:

Leeroy Jenkins

	"id": "EX1_116",
	"name": "Leeroy Jenkins",
	"text": "<b>Charge</b>. <b>Battlecry:</b> Summon two 1/1 Whelps for your opponent.",
	"rarity": "LEGENDARY",
	"type": "MINION",
	"cost": 5,
	"attack": 6,
	"health": 2,
	"collectible": true,
	"set": "EXPERT1",
	"faction": "ALLIANCE",
	"artist": "Gabe from Penny Arcade",
	"flavor": "At least he has Angry Chicken.",
	"mechanics": [
	"dust": [

Card Back objects

See full card back documentation.

Example card back:

	"description": "A generous gift from the Innkeeper.  He loves to see his guests having a good time together.\\n\\nPlay three matches against players on the same local network as you. (Must have at least 3 players on that network!)",
	"name": "Fireside",
	"prefab_name": "Assets/Game/CardBacks/Launch/Card_Back_Launch",
	"note_desc": "Fireside",
	"source": "achieve",
	"id": 4,
	"enabled": true,
	"source_description": "Special"


HearthstoneJSON is a HearthSim project and is available on GitHub.