Hearthstone API - Updated for patch: 29.2.0.198037

This Hearthstone API provides up to date Hearthstone data pulled directly from the game. It has endpoints for all the card data, including images, card backs and more.

Blizzard has not officially released any Hearthstone API's yet so I decided to make this API to fill that gap for the time being. I will update the data everytime the game data changes.

Getting Started

To access the endpoints head over to RapidAPI.

RapidAPI
Changelog

Changes 04/18/2024

  • Updated all data for patch 29.2.0.198037.

Changes 03/29/2024

  • Updated all data for patch 29.0.3.197064.

Changes 03/13/2024

  • Updated all data for patch 29.0.0.195635.

Changes 03/02/2024

  • Updated all data for patch 28.6.3.195316.

Changes 02/24/2024

  • Updated all data for patch 28.6.2.194648.

Changes 02/14/2024

  • Updated all data for patch 28.6.0.193541.

Changes 01/31/2024

  • Updated all data for patch 28.4.1.193128.

Changes 01/18/2024

  • Updated all data for patch 28.4.0.192412.

Changes 12/20/2023

  • Updated all data for patch 28.2.3.191554.

Changes 12/09/2023

  • Updated all data for patch 28.2.1.190920.

Changes 12/06/2023

  • Updated all data for patch 28.2.0.190416.

Changes 11/29/2023

  • Updated all data for patch 28.0.3.190145.

Changes 11/09/2023

  • Updated all data for patch 28.0.0.189017.

Changes 10/26/2023

  • Updated all data for patch 27.6.2.188645.

Changes 10/18/2023

  • Updated all data for patch 27.6.0.187190.

Changes 09/29/2023

  • Updated all data for patch 27.4.2.186852.

Changes 09/20/2023

  • Updated all data for patch 27.4.0.185749.

Changes 09/06/2023

  • Updated all data for patch 27.2.2.185054.

Changes 08/31/2023

  • Updated all data for patch 27.2.2.184727.

Changes 08/23/2023

  • Updated all data for patch 27.2.0.183876.

Changes 08/09/2023

  • Updated all data for patch 27.0.3.183433.

Changes 07/26/2023

  • Updated all data for patch 27.0.0.181554.

Changes 07/07/2023

  • Updated all data for patch 26.6.2.180614.

Changes 06/27/2023

  • Updated all data for patch 26.6.0.179020.

Changes 06/16/2023

  • Updated all data for patch 26.4.3.178555.

Changes 06/01/2023

  • Updated all data for patch 26.4.0.175913.

Changes 05/20/2023

  • Updated all data for patch 26.2.2.176014.

Changes 05/10/2023

  • Updated all data for patch 26.2.0.174258.

Changes 04/29/2023

  • Updated all data for patch 26.0.4.173781.

Changes 04/15/2023

  • Updated all data for patch 26.0.2.172421.

Changes 04/06/2023

  • Updated all data for patch 26.0.0.170824.

Changes 03/24/2023

  • Updated all data for patch 25.6.2.170126.

Changes 03/14/2023

  • Updated all data for patch 25.6.0.168788.

Changes 03/03/2023

  • Updated all data for patch 25.4.3.168129.

Changes 02/14/2023

  • Updated all data for patch 25.4.0.165029.

Changes 01/27/2023

  • Updated all data for patch 25.2.2.163976.

Changes 01/18/2023

  • Updated all data for patch 25.2.0.162867.

Changes 01/07/2023

  • Updated all data for patch 25.0.4.162171.

Changes 12/21/2022

  • Updated all data for patch 25.0.4.160910.

Changes 12/10/2022

  • Updated all data for patch 25.0.3.160183.

Changes 12/01/2022

  • Updated all data for patch 25.0.0.159202.

Changes 11/29/2022

  • Updated all data for "March of the Lich King" patch 25.0.0.158725.
  • Added otherRaces property to cards.
  • Added howToGetSignature property to cards.
  • Added runeCost property to cards.

Changes 11/11/2022

  • Updated all data for patch 24.6.2.155409.

Changes 11/02/2022

  • Updated all data for patch 24.6.0.154818.

Changes 10/14/2022

  • Updated all data for patch 24.4.3.152904.

Changes 09/28/2022

  • Updated all data for patch 24.4.0.150659.

Changes 09/10/2022

  • Updated all data for patch 24.2.2.149417.

Changes 09/03/2022

  • Updated all data for patch 24.2.0.148526.

Changes 08/31/2022

  • Updated all data for patch 24.2.0.148211.

Changes 08/17/2022

  • Updated all data for patch 24.0.3.147348.

Changes 07/27/2022

  • Updated all data for "Murder at Castle Nathria" patch 24.0.0.145077.

Changes 07/19/2022

  • Updated all data for patch 23.6.2.144772.

Changes 07/11/2022

  • Updated all data for patch 23.6.2.143410.

Changes 06/28/2022

  • Updated all data for patch 23.6.0.142295.

Changes 06/17/2022

  • Updated all data for patch 23.4.3.141643.

Changes 06/02/2022

  • Updated all data for patch 23.4.0.139963.

Changes 05/20/2022

  • Updated all data for patch 23.2.2.139719.

Changes 05/14/2022

  • Updated all data for patch 23.2.0.138759.

Changes 05/10/2022

  • Updated all data for patch 23.2.0.137922.

Changes 04/27/2022

  • Updated all data for patch 23.0.3.137436.

Changes 04/07/2022

  • Updated all data for "Voyage to the Sunken City" patch 23.0.0.135540.

Changes 03/22/2022

  • Updated all data for patch 22.6.0.134558.

Changes 03/18/2022

  • Updated all data for patch 22.6.0.133923.

Changes 03/04/2022

  • Updated all data for patch 22.4.3.133122.

Changes 02/16/2022

  • Updated all data for patch 22.4.0.131660.

Changes 02/11/2022

  • Updated all data for patch 22.2.2.131337.

Changes 01/26/2022

  • Updated all data for patch 22.2.0.130051.

Changes 12/21/2021

  • Updated all data for patch 22.0.2.128654.

Changes 12/06/2021

  • Updated all data for patch 22.0.0.127581.

Changes 11/30/2021

  • Updated all data for "Fractured in Alterac Valley" patch 22.0.0.126807.

Changes 11/17/2021

  • Updated all data for patch 21.8.0.126451.

Changes 11/03/2021

  • Updated all data for patch 21.6.0.124497.

Changes 10/21/2021

  • Updated all data for patch 21.4.4.121569.

Changes 10/13/2021

  • Updated all data for patch 21.4.0.95431.

Changes 09/22/2021

  • Updated all data for patch 21.3.0.93849.

Changes 09/01/2021

  • Updated all data for patch 21.2.0.91456.

Changes 08/18/2021

  • Updated all data for patch 21.0.3.91040.

Changes 07/29/2021

  • Updated all data for "United in Stormwind" patch 21.0.0.88998.

Changes 07/15/2021

  • Updated all data for patch 20.8.2.88605.

Changes 07/02/2021

  • Updated all data for patch 20.8.0.86601.

Changes 06/16/2021

  • Updated all data for patch 20.4.2.86314.

Changes 06/03/2021

  • Updated all data for patch 20.4.0.84593.

Changes 05/15/2021

  • Updated all data for patch 20.2.2.83143.

Changes 05/04/2021

  • Updated all data for patch 20.2.0.81706.

Changes 04/13/2021

  • Updated all data for patch 20.0.2.79904.

Changes 03/25/2021

  • Updated all data for "Forged in the Barrens" patch 20.0.0.77662.
  • Added spellSchool property to cards.
  • Added howToGetDiamond property to cards.

Changes 02/20/2021

  • Updated all data for patch 19.6.0.74257.

Changes 02/09/2021

  • Updated all data for patch 19.4.1.73652.

Changes 01/30/2021

  • Updated all data for patch 19.4.1.72661.

Changes 01/22/2021

  • Updated all data for patch 19.4.0.71603.

Changes 01/21/2021

  • Updated all data for patch 19.4.0.71003.

Changes 01/09/2021

  • Updated all data for patch 19.2.1.70986.

Changes 12/16/2020

  • Updated all data for patch 19.2.0.68600.

Changes 11/20/2020

  • Updated all data for patch 19.0.0.66927.

Changes 11/12/2020

  • Updated all data for patch 19.0.0.65614.

Changes 11/06/2020

  • Updated all data for patch 18.6.1.65000.

Changes 10/22/2020

  • Updated all data for patch 18.6.0.63160.

Changes 10/16/2020

  • Updated all data for patch 18.4.2.62331.

Changes 09/29/2020

  • Updated all data for patch 18.4.0.60352.

Changes 09/15/2020

  • Updated all data for patch 18.2.0.58638.

Changes 09/08/2020

  • Updated all data for patch 18.2.0.58213.

Changes 08/18/2020

  • Updated all data for patch 18.0.2.56359.

Changes 07/31/2020

  • Updated all data for patch 18.0.0.54613.

Changes 07/15/2020

  • Updated all data for patch 17.6.0.53261.

Changes 06/18/2020

  • Updated all data for patch 17.4.1.51510.

Changes 06/09/2020

  • Updated all data for patch 17.4.0.49534.

Changes 05/22/2020

  • Updated all data for patch 17.2.2.48705.

Changes 05/19/2020

  • Updated all data for patch 17.2.1.48313.

Changes 05/13/2020

  • Updated all data for patch 17.2.0.47374.

Changes 04/21/2020

  • Updated all data for patch 17.0.2.45932.

Changes 04/09/2020

  • Updated all data for patch 17.0.0.45310.

Changes 03/31/2020

  • Updated all data for patch 17.0.0.44582.

Changes 03/27/2020

  • Updated all data for patch 17.0.0.44222.

Changes 03/17/2020

  • Updated all data for patch 16.6.0.43246.

Changes 02/28/2020

  • Updated all data for patch 16.4.0.42174.

Changes 02/06/2020

  • Updated all data for patch 16.2.3.40734.

Changes 01/21/2020

  • Updated all data for "Galakrond's Awakening" patch 16.2.0.39954.

Changes 01/09/2020

  • Updated all data for patch 16.0.8.39282.

Changes 12/20/2019

  • Updated all data for patch 16.0.5.38377.

Changes 12/16/2019

  • Updated all data for patch 16.0.3.38203.

Changes 12/12/2019

  • Updated all data for patch 16.0.0.38034.

Changes 12/05/2019

  • Updated all data for "Descent of Dragons" patch 16.0.0.37060.

Changes 11/11/2019

  • Updated all data for patch 15.6.2.36393.

Changes 11/05/2019

  • Updated all data for patch 15.6.0.35747.

Changes 10/15/2019

  • Updated all data for patch 15.4.0.35057.

Changes 10/09/2019

  • Updated all data for patch 15.4.0.34670.

Changes 09/20/2019

  • Updated all data for patch 15.2.2.34104.

Changes 09/10/2019

  • Updated all data for patch 15.2.0.33717.

Changes 08/26/2019

  • Updated all data for patch 15.0.4.33402.

Changes 08/14/2019

  • Updated all data for patch 15.0.2.33157.

Changes 08/01/2019

  • Updated all data for "Saviors of Uldum" patch 15.0.0.32708.

Changes 07/01/2019

  • Updated all data for patch 14.6.0.31761.

Changes 06/12/2019

  • Updated all data for patch 14.4.3.31532.

Changes 06/07/2019

  • Updated all data for patch 14.4.0.31353.

Changes 06/03/2019

  • Updated all data for patch 14.4.0.31268.

Changes 05/22/2019

  • Updated all data for patch 14.2.2.31022.

Changes 05/14/2019

  • Updated all data for patch 14.2.0.30795.

Changes 04/09/2019

  • Updated all data for patch 14.0.0.30103.

Changes 04/05/2019

  • Updated all data for "Rise of Shadows" patch 14.0.0.29933.

Changes 03/14/2019

  • Updated all data for patch 13.4.0.29349.

Changes 02/11/2019

  • The API now always enforces HTTPS. If you are using the Slack integration, please change your Outgoing WebHook URL(s) to: https://hearthstoneapi.com/webhook/slack.

Changes 02/06/2019

  • Updated all data for patch 13.2.0.28855.

Changes 01/29/2019

  • Updated all data for patch 13.0.9.28556.

Changes 12/21/2018

  • Updated all data for patch 13.0.3.28329.

Changes 12/10/2018

  • Updated all data for patch 13.0.3.28116.

Changes 11/29/2018

  • Updated all data for "Rastakhan's Rumble" patch 13.0.0.27845.

Changes 11/07/2018

  • Updated all data for patch 12.4.0.27641.

Changes 11/05/2018

  • Updated all data for patch 12.4.0.27405.

Changes 10/19/2018

  • Updated all data for patch 12.2.0.27358.

Changes 10/14/2018

  • Updated all data for patch 12.2.0.27059.

Changes 10/04/2018

  • Updated all data for patch 12.2.0.26996.

Changes 08/02/2018

  • Updated all data for "The Boomsday Project" patch 12.0.0.25770.

Changes 07/10/2018

  • Updated all data for patch 11.4.0.25252.

Changes 06/07/2018

  • Updated all data for patch 11.2.0.24769.

Changes 05/22/2018

  • Updated all data for patch 11.1.1.24589.

Changes 05/12/2018

  • Updated all data for patch 11.1.0.24377.

Changes 04/11/2018

  • Updated all data for "The Witchwood" patch 11.0.0.23966.

Changes 03/13/2018

  • Updated all data for patch 10.4.0.23576.

Changes 02/06/2018

  • Updated all data for patch 10.2.0.23180.

Changes 12/07/2017

  • Updated all data for "Kobolds & Catacombs" patch 10.0.0.22611.

Changes 11/07/2017

  • Updated all data for patch 9.4.0.22115.

Changes 10/18/2017

  • Updated all data for patch 9.2.0.22017.

Changes 10/17/2017

  • Updated all data for patch 9.2.0.21517.

Changes 09/18/2017

  • Updated all data for patch 9.1.0.20970.

Changes 08/08/2017

  • Updated all data for "Knights of the Frozen Throne" patch 9.0.0.20457.
  • Added armor property to cards.

Changes 07/12/2017

  • Updated all data for patch 8.4.0.20022.

Changes 06/16/2017

  • Added dbfId property to cards.

Changes 06/13/2017

  • Updated all data for patch 8.2.2.19632.

Changes 06/01/2017

  • Updated all data for patch 8.2.0.19506.

Changes 04/21/2017

  • Updated all data for patch 8.0.4.18792.

Changes 04/06/2017

  • Classic cards that are now part of the "Hall of Fame" set have been updated to reflect this change.
  • The keyword "Quest" has been added as a mechanic.

Changes 04/04/2017

  • Updated all data for "Journey to Un'Goro" patch 8.0.0.18336.

Changes 03/10/2017

  • Updated all data for patch 7.1.1.17994.

Changes 02/28/2017

  • Updated all data for patch 7.1.0.17720.

Changes 12/03/2016

  • Neutral cards playerClass property is now set to Neutral.
  • The classes set returned by the info endpoint now contains Neutral.
  • Added multiClassGroup property to cards to support Gadgetzan's tri-class cards. Example values: Grimy Goons, Jade Lotus, Kabal.
  • Added classes property to cards to support Gadgetzan's tri-class cards. Example value for a Kabal tri-class card: Mage, Priest, Warlock.
  • Removed duplicate card text.

Changes 11/30/2016

  • Updated all data for "Mean Streets of Gadgetzan" patch 7.0.0.15590.

Changes 11/11/2016

  • Updated all data for patch 6.2.0.15300.

Changes 10/20/2016

  • Updated all data for patch 6.2.0.15181.

Changes 10/03/2016

  • Updated all data for patch 6.1.3.14830.

Changes 09/15/2016

  • Updated all data for patch 6.1.1.14406.

Changes 08/09/2016

  • Updated all data for patch 6.0.0.13921.

Changes 07/26/2016

  • Updated all data for patch 5.2.2.13807.

Changes 07/16/2016

  • Updated all data for patch 5.2.0.13740.

Changes 07/12/2016

  • Updated all data for patch 5.2.0.13619.

Changes 07/06/2016

  • A list of standard and wild sets have been added to the info endpoint.

Changes 06/30/2016

  • Card set "Promotion" has been renamed to "Promo" to better represent game data.

Changes 06/01/2016

  • Updated all data for patch 5.0.0.13030.

Changes 04/24/2016

  • Updated all data for "Whispers of the Old Gods" patch 5.0.0.12574.

Changes 04/15/2016

  • Updated all data for patch 4.3.0.12266.

Changes 03/14/2016

  • Updated all data for patch 4.2.0.12051.
  • Added support for the thTH (Thailand) locale.

Changes 01/16/2016

  • Card mechanics are now returned in the correct locale.

Changes 12/19/2015

  • You can now pass 'Neutral' to the class endpoint in order to return cards that don't belong to a specific class.

Changes 12/04/2015

  • Added new Tavern Brawl data.
  • Added Thrall, Love Is in the Air, Winter Veil Wreath and Thunder Bluff card backs.
  • Durability is now properly returned as an integer instead of a string.

Changes 11/11/2015

  • Updated all data for The League of Explorers (patch 4.0.0.10833)

Changes 10/20/2015

  • Updated for patch 3.2.0.
  • Added Highmaul card back.

Changes 09/30/2015

  • Added Exodar and Power Core card backs.
  • Added new tavern brawl cards.

Changes 09/15/2015

  • Slack integration now supports --gold parameter for returning gold images.

Changes 08/18/2015

  • Added The Grand Tournament data.
  • Added Tournament Grounds card back.

Changes 08/02/2015

  • The Card Backs data has been revamped to better represent the game data.
  • Card Backs are no longer split into categories.
  • Card Backs data now includes cardBackId, name, description, source, sourceDescription, enabled, img, imgAnimated, sortCategory, sortOrder and locale.
  • Card Backs can now be requested in different locales.

Changes 07/29/2015

  • Added Darkspear and Grand Tournament card backs.
  • Moved Molten Core and Grand Tournament card backs into new category called Pre-order.

Changes 06/16/2015

  • Updated all data for patch 2.7.0.9166
  • Added new sets Hero Skins and Tavern Brawl.
  • Added Darnassus, Galaxy Gifts, Magni, Medivh and Alleria card backs.

Changes 06/08/2015

  • Info endpoint now supports the locale parameter.

Changes 05/26/2015

  • Added Card Backs endpoint.

Changes 05/05/2015

  • Added Card Search endpoint.
  • Removed image URLs from enchantments since it doesn't apply.
  • You can now request a card and have it returned in a different locale. Example: requesting Circle of Healing with ?locale=deDE will return the german version of the card. Before you were required to type the german name of the card.
Endpoints
Endpoints Description
/info Returns a list of current patch, classes, sets, types, factions, qualities, races and locales.
/cards Returns all available Hearthstone cards including non collectible cards.
/cards/{name} Returns card by name or ID. This may return more then one card if they share the same name. Loatheb returns both the card and the boss.
/cards/search/{name} Returns cards by partial name.
/cards/sets/{set} Returns all cards in a set. Example values: Blackrock Mountain, Classic.
/cards/classes/{class} Returns all the cards of a class. Example values: Mage, Paladin.
/cards/races/{race} Returns all the cards of a certain race. Example values: Mech, Murloc.
/cards/qualities/{quality} Returns all the cards of a certain quality. Example values: Legendary, Common.
/cards/types/{type} Returns all the cards of a certain type. Example values: Spell, Weapon.
/cards/factions/{faction} Returns all the cards of a certain faction. Example values: Horde, Neutral.
/cardbacks Returns a list of all the card backs.
Example Data
Leeroy Jenkins
Leeroy Jenkins 
							
                                {
    "cardId": "EX1_116",
    "dbfId": 559,
    "name": "Leeroy Jenkins",
    "cardSet": "Classic",
    "type": "Minion",
    "faction": "Alliance",
    "rarity": "Legendary",
    "cost": 5,
    "attack": 6,
    "health": 2,
    "text": "<b>Charge</b>. <b>Battlecry:</b> Summon two 1/1 Whelps for your opponent.",
    "flavor": "At least he has Angry Chicken.",
    "artist": "Gabe from Penny Arcade",
    "collectible": true,
    "elite": true,
    "playerClass": "Neutral",
    "img": "https://d15f34w2p8l1cc.cloudfront.net/hearthstone/7740c50c88d17b12c3eccbf1c57af9163929add6c63bba7fbad663f574bc6307.png",
    "imgGold": "https://d15f34w2p8l1cc.cloudfront.net/hearthstone/cf21572abd2583e7520733ac221c35fd5aeb5d700de9b43895712a74c2c68eb4.png",
    "locale": "enUS",
    "mechanics": [
        {
            "name": "Charge"
        },
        {
            "name": "Battlecry"
        }
    ]
}
Key Description
cardId The card ID.
dbfId The card DBF ID. Can be used to generate deckstrings.
name The card name.
cardSet The set name.
type The card type. Example values: Minion, Spell, Weapon, Hero, Hero Power, Enchantment.
faction The faction of the card. Example values: Alliance, Horde, Neutral.
rarity The rarity of the card. Example values: Free, Common, Rare, Epic, Legendary.
cost The mana cost of this card.
attack The attack of the card.
health The health of the card.
durability The durability of the card. Used for Weapons.
armor The armor of the card. Seen on hero cards from the Knights of the Frozen Throne expansion.
text The text of the card when it is in your hand.
inPlayText The text of the card when it is in play.
flavor The flavor text of the card.
artist The artist of the card.
collectible Indicates if the card is collectible.
elite Indicates if the card is elite.
race The race of the card. Example values: Murloc, Demon, Beast, Totem, Pirate, Dragon, Undead.
otherRaces The other races of the card. Example values: Murloc, Demon, Beast, Totem, Pirate, Dragon, Undead.
playerClass The player class this card belongs to. Example values: Druid, Hunter, Mage, Paladin.
multiClassGroup Indicates that this card belongs to multiple classes. First introduced in the Mean Streets of Gadgetzan expansion. Example values: Grimy Goons, Jade Lotus, Kabal.
classes Indicates which classes this card belongs to. Only applies to multi class cards. Example value for a Kabal tri-class card: Mage, Priest, Warlock.
howToGet How to get this card. Only present if you can obtain this card from a method other than opening a booster pack.
howToGetGold How to get the gold version of this card. Only present if you can obtain this card from a method other than opening a booster pack.
howToGetSignature How to get the signature version of this card.
howToGetDiamond How to get the diamond version of this card.
runeCost The rune cost of this card.
img Image URL. Only present if image is available.
imgGold Golden image URL. Only present if golden image is available.
locale The locale of the card. Available locales: enUS, enGB, deDE, esES, esMX, frFR, itIT, koKR, plPL, ptBR, ruRU, zhCN, zhTW, jaJP, thTH.
mechanics The mechanics of the card. Example values: Windfury, Combo, Secret, Battlecry, Deathrattle, Taunt.
Darkspear
Darkspear 
							
								{
    "cardBackId": 30,
    "name": "Darkspear",
    "description": "Vol'jin's tribe, the Darkspear trolls, no longer practices cannibalism. Officially.",
    "source": "1",
    "howToGet": "Acquired from achieving Rank 20 in Ranked Play, July 2015.",
    "enabled": true,
    "img": "https://d15f34w2p8l1cc.cloudfront.net/hearthstone/a7257343c22e7973e37edb7d2905d44e9e39994ec60f2fc748a6570048d230f2.png",
    "imgAnimated": "https://d15f34w2p8l1cc.cloudfront.net/hearthstone/a7257343c22e7973e37edb7d2905d44e9e39994ec60f2fc748a6570048d230f2.png",
    "sortCategory": 5,
    "sortOrder": 0,
    "locale": "enUS"
}
Key Description
cardBackId The card back ID.
name The card back name.
description The card back description.
source The card back source. Example values: achieve, season, fixed_reward.
sourceDescription The card back source description. Example values: Default, Season, Legend.
howToGet How to get this card back.
enabled Determines if this card back is enabled in-game.
img Image URL. Only present if image is available.
imgAnimated Animated image URL. Only present if animated image is available.
sortCategory The sort category of the card back. In combination with sortOrder, this is used in-game to determine the order of the card backs.
sortOrder The sort order of the card back. In combination with sortCategory, this is used in-game to determine the order of the card backs.
locale The locale of the card back. Available locales: enUS, enGB, deDE, esES, esMX, frFR, itIT, koKR, plPL, ptBR, ruRU, zhCN, zhTW, jaJP, thTH.
Slack Integration

If your interested in showing a Hearthstone card in one of your Slack channels, add the webhook below to outgoing webhooks and setup one or more trigger words.

Webhooks Description
https://hearthstoneapi.com/webhook/slack Returns card info in Slack format.

To return gold images append --gold to your request. Example: card Ysera --gold.