This post is to provide advance warning to developers that Scryfall’s data model will soon change how we present split cards, flip cards, and card images. The changes will unfortunately be backwards-incompatible with the previous API.

A new field images will be added to the card object with normal and large properties with URIs to each version.

The image property will continue pointing to the normal version of the image, but is now deprecated.

Not all cards will have high-res images immediately. This change will likely creep out to newer sets and expansion sets first, then to all supplemental sets. When a card doesn’t have a high-res image, its images.large property will be null.

The system we’re building to make this change opens up a bunch of future possibilities with card images: art crops, square crops, consistently rounded corners, and more. Let us know what you want to see out of this. Stay tuned!

Split Cards and Flip Cards

Because users so often search for the combined name of split cards or search “across” the two halves of split cards (to discover casting loopholes, etc) we will be combiningsplit cards and flip cards into a single object representing both halves of the card.

The name field for a split/flip card object will contain both names of the card. For example Wear // Tear

The mana_cost field for a split/flip card object will contain both values on the card. For example {1}{R} // {W}

A new faces field will contain two card_face objects that will have the distinct name, mana_cost, type_line, oracle_text, power, and toughness information for each face of the split/flip card.

The parent-level fields type_line, oracle_text, power, and toughness will be null for split/flip cards.

Other parent fields such as multiverse_id, prices, set information, etc will be unchanged.

These new combined card objects will replace the previous left-side/top-side object in our results. The object for the other side will be deleted.

For example, our current object for DGM Wear has ID d169a3b2… and the object for DGM Tear has ID bd0f7a22…. When this update occurs there will be only one object with ID d169a3b2… called Wear // Tear.

Partial name searches will now match either side of the card or both. For example searching for we tea will now include Wear // Tear.

In addition, our chat bots will now return both halves of a split/flip card when you search for one or both sizes. For example [[Wear]] and [[Wear//Tear]] will now find Wear // Tear.

Transform and meld cards are unaffected by this update. They will remain distinct cards with an all_parts field as usual.

Thank you!

Thank you so much from the bottom of our hearts for using our API. We’ve been delighted by the things we’re seeing people build. If you have any questions or feedback about these changes, please send us a message.

Scryfall

Account

Developer

Other Planes

The literal and graphical information presented on this site
about Magic: The Gathering, including card images, the mana symbols, and Oracle text,
is copyright Wizards of the Coast, LLC, a subsidiary of Hasbro, Inc.
This website is not produced by, endorsed by, supported by,
or affiliated with Wizards of the Coast.

The Slack logo and Slack API are copyright Slack Technologies, Inc.
The Discord logo and Discord API are copyright Discord, Inc.
Scryfall is not created by, affiliated with, or supported by Slack Technologies and Discord.

Card prices represent daily averages and/or market values provided by our affiliates.
Absolutely no guarantee is made for any price information.
See stores for final prices and availability.