# Frequently Asked Questions

Here is a list of frequently asked questions from our users since some data can be nuanced.

# Which file should I use for my project?

In most cases, AllPrintings is the correct file. It contains all data for every printing of each card organized by set, however, this file is quite large. Alternatively, you can browse the All Sets and All Decks files or even download Databases.

Note: The JSON files are minified, and not human-readable. Depending on your implementation, you can use a software like JQ (opens new window) to parse and process them.

# Which file formats should I use for my project?

We recommend downloading the compressed files and unpacking them on your local/remote drive. This would be faster than downloading the JSON files.

# Where does the data come from?

Data is collected from a variety of sources, including Magic: The Gathering's own Gatherer (opens new window), API's like Scryfall (opens new window) and TCGplayer (opens new window), and many more. For more information, or if you would like to help, please join our Discord (opens new window)!

# How much does MTGJSON cost?

MTGJSON is free and open source under the License (MIT). If you find this project useful, please consider helping us to keep the lights on and develop new features for you with a one-time donation using PayPal or recurring donations using Patreon.

# How can I help, report a bug, etc?

You can contribute to the project through the main MTGJSON repo (opens new window) or the MTGJSON website repo (opens new window). If you are a data provider and would like to integrate your data with us, please join our Discord (opens new window).

# How often is the data updated?

Builds kick off at 2:00AM ET taking between 4-5 hours to complete and go live at 7:00AM ET.

# Can I verify the downloaded files?

Yes. Every file has a SHA-256 file available at the same URL location appended with .sha256.

  • Example: https://mtgjson.com/api/v5/AllPrintings.json.sha256

# How do I access a card's imagery?

While we do not offer card images directly through MTGJSON, we recommend getting card images through Scryfall (opens new window) or Gatherer (opens new window) using the MTGJSON property from the Identifiers Data Model within the various Card Data Models.

  • Scryfall: https://api.scryfall.com/cards/${scryfallId}?format=image

  • Gatherer: https://gatherer.wizards.com/Handlers/Image.ashx?type=card&multiverseid=${multiverseId}

  • Note: Gatherer (opens new window) may not have all images. If a multiverseId is missing, the imagery will not exist there. For Scryfall (opens new window), to access another face of a card, such as "transform" or "meld" cards, add &face=front or &face=back to the url to get the respective image.

# How can I access a card's set imagery?

The keyruneCode property from the Set Data Model provides information you need for implementing set code imagery but is mostly limited to projects that can use CSS, however, there is ways to use them in desktop applications. See the Keyrune official documentation (opens new window) for more information.

Additionally, you can use Gatherer (opens new window) for a limited amount of set printings using the following Gatherer API.

Example: https://gatherer.wizards.com/Handlers/Image.ashx?type=symbol&set=${setCode}&rarity=${rarity}&size=large

In this case, rarity is just the starting letter of the rarity, such as m, r, u, or c.

# How do I find the other card faces of "Meld" cards?

The most effective way to get the other cards for "Meld" cards is to access the otherFaceIds property of any of the "Meld" cards. This property will return two uuid values for the other associated cards.

Note: Depending on your use case, this can be enough data to get the information you need, otherwise you can use those cards to access their otherFaceIds to get the card you need by comparing the data that you have already.

# What information is in AtomicCards or similar files?

These files contains oracle-like information for every card using the Card (Atomic) Data Model. Any data that is persistent across the printings of a card will be included, such as colorIdentity, but anything that pertains to a specific printing of a card will NOT be included, such as artist.

For a full list of properties, see the Card (Atomic) Data Model documentation.

Note: Depending on your use case you probably do not need this file, as it can be easily derived from AllPrintings - handle with care.

# Why is a file/website out of date?

You have probably received a cached version of the file or website. If you are using the website or have a file open in the browser, try hard‑refreshing the url (CTRL + F5 on Windows, Shift + Command + R on MacOS).