MTGJSON

# MTGJSON Changelog

The following is the MTGJSON Application Changelog. Some parts may be updated for clarity or corrections at any point.

# 5.1.0

Release Date: 2021-01-18

# Announcements

Welcome to the next release of MTGJSON - With this release we are no longer supporting Version 4, so if you have not already, please update all your sources to the Version 5 endpoints to ensure your applications function correctly going forward.

MTGGraphQL logoWe're rolling out MTGGraphQL! For more information see the MTGGraphQL documentation. Access during our beta rollout is limited to Patreon supporters.
A GraphQL GUI can be accessed via https://mtgjson.com/graphql (opens new window).



Note: With this release, MTGJSONv4 has been fully deprecated. On February 28th, 2021 all v4 endpoints will be removed.

# Files

# Added

  • Added TcgplayerSkus.* file for download which contains TCGplayer SKU information organized by card UUID
  • Added more data to the SetList file
  • Added asciiName property to Atomic* files
  • Added Identifiers model to the Atomic* files
  • Added currency to AllPrices file (Thanks, tpblaster!)
  • Added type property to DeckList file

# Updated

  • Updated the order of keys so that the meta key appears at the top.

# Card Model

# Added

  • Added originalReleaseDate property
  • Added layout to be "token" if a set is only tokens

# Fixed

  • Fixed cards with art_series type
  • Fixed isAlternative for cards within a single set (Thanks, kodabb!)

# Card (Atomic) Model

# Added

  • Added keywords

# Set Model

# Added

  • Added mcmIdExtras property (Thanks, mjainta!)

# Deck Model

# Added

  • Added commander property

# Legalities Model

# Added

  • Added missing Historic property

# Updated

# Sets

# Added

  • Added Arena Beginner Set (ANB)
  • Added Amonkhet Remastered (AKR)
  • Added Zendikar Rising (ZNR)
  • Added The List (PLIST)
  • Added Kaladesh Remastered (KLR)
  • Added Commander Legends (CMR)
  • Added Commander Collection: Green (CC1)
  • Added Kaldheim, spoilers (KHM)
  • Added Time Spiral Remastered, spoilers (TSR)

# Fixed

  • Salvat 2005 is correctly marked as foreign (Thanks, silasary!)

# Misc

# Added

  • Added new error page
  • Fixed an issue where models without optional properties were able to be filtered

# Updated

  • MTGJSON has dropped TravisCI support in favor of GitHub Actions (Thanks, ebbit1q!)

# 5.0.1

Release Date: 2020-08-24

# Files

# Added

  • Added AllIdentifiers.* file for download which contains all cards organized by UUID

# Card

# Added

  • Added setCode to the non-atomic and token card model
  • Added faceName to Foreign Data model

# Set

# Fixed

  • Fixed some translation inaccuracies
  • Fixed some keyruneCode inaccuracies

# 5.0.0

Release Date: 2020-07-03

# Announcements

New MTGJSON LogoWe are proud to announce the 5th major release of MTGJSON! The team has made big improvements including a new “API” endpoint to serve files. We have also given our documentation an overhaul - including upgrading our server to run on Nginx.

We are also pleased to announce the addition of Booster information on the Set data model. For more information, see the documentation for Booster data model.

If you have suggestions for improvements, bug reports, or would just like to help address existing issues, we are always looking for help. You can contribute to the project through the main MTGJSON repo (opens new window) or the MTGJSON website repo (opens new window). If you would like to help in other ways please consider donating to the project via PayPal (one-time donation) or via Patreon (recurring donations).

The MTGJSON team we would like to thank the community for its continued support and we look forward to serving you well.


# Card

# Changed

  • Changed "Meld" card name and side to be more clear. Example: "Gisela, the Broken Blade // Brisela, Voice of Nightmares" (side a), "Bruna, the Fading Light // Brisela, Voice of Nightmares" (side a), and "Brisela, Voice of Nightmares" (side b)
  • Changed mcmId, mcmMetaId, mtgoFoilId, mtgoId, multiverseId, scryfallId, scryallIllustrationId, scryfallOracleId, and tcgplayerProductId properties to be nested in to a new identifiers property. mtgstocksId was removed for redundancy
  • Changed isArena, isMtgo, and isPaper to be nested inside a new availability property. Values return a string of the available property. See the available examples for all the values
  • Changed isBuyABox, isBundle, isPlaneswalkerStamped, and isDateStamped to be nested in to a new promoTypes property
  • Changed name to show full split card names (name1 // name2)
  • Changed name to be verbatim as printed on the card (see Unglued variants for example)
  • Changed names to otherFaceIds
  • Changed uuid for all tokens and split cards
  • Changed hasNoDeckLimit to hasAlternativeDeckLimit

# Added

  • Added hasAlternativeDeckLimit for cards that allow a limit other than 4
  • Added promoTypes for an enums for promo cards which replaces other promo properties
  • Added and back-ported hasContentWarning for cards that are marked by Wizards of the Coast (opens new window) for having sensitive content
  • Added variations to show all cards with the same name
  • Added keywords for all keywords available on a card
  • Added mtgjsonV4Id to identifiers to help transition developer's code
  • Added faceName to identify only the card face card's name

# Sets

# Added

  • Added booster. See the Booster data model
  • Added isPartialPreview
  • Added Love Your LGS (PLGS)
  • Added Historic Anthology 3 (HA3)
  • Added Secret Lair: Ultimate Edition (SLU)
  • Added Signature Spellbook: Chandra SS3)
  • Added Core Set 2021 (M21)
  • Added Jumpstart (JMP)
  • Added Double Masters (2XM)

# Removed

  • Removed boosterV3

# Files

# Changed

  • All file downloads are now available via the /api/v5/* web-based url
  • The AllCards file is now renamed AtomicCards to better clarify that these files only contain atomic card data
  • The [Format]Printings files are now renamed to just their format name: Modern, Legacy, etc
  • The version file is now renamed Meta
  • All files now used a top-level data and meta key. Any data models inside of data should lose the nested meta object

# Added

# Misc

# Added

  • Added Phyrexian language where language data is available

# Website

# Updated

  • The documentation application server was switched over to Nginx

# Changed

  • Data "Structures" are now named "Models"
  • Models now reference their parent keys and parent files more accurately
  • Models now have the "optional" attribute marked on more properties for clarity
  • Some text and spacing adjustments for the "Changelog" and "FAQ" page
  • The Legalities model now more clearly shows which properties would be omitted

# Added

  • More models are clearly defined now that the files deliver all the same top-level keys
  • Atomic Cards are now documented outright as a Data Model for clarity
  • Property value examples were added for properties with enum values
  • You can now toggle optional properties on/off within documentation. If all properties are optional than the UI is disabled
  • You can now try to edit/PR a specific documentation from the page footer

# Removed

  • /file/* (Documentation): Files are longer documented individually, instead their contents are pure data models
  • The "About Us" page no longer uses a table of contents
  • setCode was mistakenly added and is now removed to the Card data model