Card

The card structure describes the properties and values of a single card.

Potential Parent property: cards
Potential Parent property type: array(anonymous object)
Property type: string

Structure

Deprecation Warning

tcgplayerPurchaseUrl will be deprecated in v4.5.0. purchaseUrls is now a key that will contain multiple purchase urls.

propertytypeexampledescription

artist

string
"Ryan Yee"
Name of the artist that illustrated the card art.

borderColor

string
"black"
Color of the border. Can be {{code:black}}, {{code:borderless}}, {{code:gold}}, {{code:silver}} or {{code:white}}.

colorIdentity

array(string)
["B"]
List of all colors in card’s mana cost, rules text and any color indicator.

colorIndicator

array(string)
["B","R"]
List of all colors in card’s color indicator (a symbol showing the colors of the card). Usually found only on cards without mana costs and other special cards.

colors

array(string)
["B","R"]
List of all colors in card’s mana cost and any color indicator. Some cards are special (such as Devoid cards or other cards with certain rules text).

convertedManaCost

float
5.0
The converted mana cost of the card.

duelDeck

string
"a"
If the card is in a duel deck product, can be {{code:a}}(left) or {{code:b}}(right). (If not in duel deck product, duelDeck is usually ommitted.)

faceConvertedManaCost

float
5.0
The converted mana cost of the face of either half or part of the card.

flavorText

string
"Whatever hatred destroys, a single act of trust can revive."
Italicized text found below the rules text that has no game function.

foreignData

array(object)
{{link:foreign-data}}
See the {{link:foreign-data}} structure.

frameEffect

string
"legendary"
Values can be {{code:colorshifted}}, {{code:compasslanddfc}}, {{code:devoid}}, {{code:draft}}, {{code:legendary}}, {{code:miracle}}, {{code:mooneldrazidfc}}, {{code:nyxtouched}}, {{code:originpwdfc}}, {{code:sunmoondfc}} or {{code:tombstone}}.

frameVersion

string
"2015"
Version of the card frame style. Can be {{code:1993}}, {{code:1997}}, {{code:2003}}, {{code:2015}} or {{code:future}}.

hand

string
"+0"
Starting maximum hand size total modifier. A plus or minus character preceeds an integer. Used only on Vanguard cards.

hasFoil

boolean
true
Can the card be found in foil? (If false, it is usually omitted.)

hasNonFoil

boolean
true
Can the card be found in non-foil? (If false, it is usually omitted.)

isAlternative

boolean
true
The card has some kind of alternative variation to its printed counterpart. (If false, it is usually omitted.)

isArena

boolean
true
Is the card available in Magic: The Gathering Arena? (If false, it is usually omitted.)

isFullArt

boolean
true
Is the card full artwork? (If false, it is usually omitted.)

isMtgo

boolean
true
Is the card available in Magic: The Gathering Online? (If false, it is usually omitted.)

isOnlineOnly

boolean
true
Is the card only available online? (If false, it is usually omitted.)

isOversized

boolean
true
Is the card oversized? (If false, it is usually omitted.)

isPaper

boolean
true
Is the card available in print? (If false, it is usually omitted.)

isPromo

boolean
true
Is the card a promotional print? (If false, it is usually omitted.)

isReprint

boolean
true
Has the card been reprinted? (If false, it is usually omitted.)

isReserved

boolean
true
Is the card on the MTG Reserved List? (If false, it is usually omitted.)

isStarter

boolean
true
If this card is found in a booster pack. (If false, it is usually omitted.)

isStorySpotlight

boolean
true
Does the card have a story spotlight? (If false, it is usually omitted.)

isTextless

boolean
true
Does the card normally have a text box, but doesn't on this card? (If false, it is usually omitted.)

isTimeshifted

boolean
true
Card is “timeshifted”, a feature from Time Spiral block. (If false, it is usually omitted.)

layout

string
"normal"
Type of card layout. Can be {{code:normal}}, {{code:split}}, {{code:flip}}, {{code:transform}}, {{code:meld}}, {{code:leveler}}, {{code:saga}}, {{code:planar}}, {{code:scheme}}, {{code:vanguard}}, {{code:token}}, {{code:double_faced_token}}, {{code:emblem}}, {{code:augment}}, {{code:aftermath}} or {{code:host}}. (If normal, it is usually omitted.)

legalities

object
{{link:legalities}}
See the {{link:legalities}} structure.

life

string
"+0"
Starting life total modifier. A plus or minus character preceeds an integer. Used only on Vanguard cards.

loyalty

string
"7"
Planeswalker loyalty value.

manaCost

string
"{3}{W}{W}"
Mana cost of the card.

mcmId

integer
371878
The Magic Card Market card id.

mcmMetaId

integer
269313
The Magic Card Market card meta id.

mcmName

string
"Angel of Grace"
The Magic Card Market card name.

mtgstocksId

integer
40272
mtgstocks.com card id.

multiverseId

integer
457145
An integer most cards have which Wizards uses as a card identifier.

name

string
"Angel of Grace"
Names of each face on the card. Meld cards are listed in the order of {{code:CardA}}, {{code:Meld}}, {{code:CardB}}.

names

array(string)
["Nicol Bolas, the Ravager","Nicol Bolas, the Arisen"]
Names of each face on the card. Meld cards are listed in the order of CardA, Meld, CardB.

number

string
"218"
Number of the card.

originalText

string
"Reach (This creature can block creatures with flying.)\nDeathtouch (Any amount of damage this deals to a creature is enough to destroy it.)"
Text on the card as originally printed.

originalType

string
"Legendary Creature — Angel"
Type as originally printed. Includes any supertypes and subtypes. ("Legendary Creature — Angel")

power

string
"5"
Power of the creature.

prices

object(string: object)
{{link:prices}}
See the {{link:prices}} structure.

printings

array(string)
["M19","PM19"]
List of sets the card was printed in, in uppercase.

purchaseUrls

array(string: string)
{{link:purchase-urls}}
See the {{link:purchase-urls}} structure.

rarity

string
"mythic"
Rarity. Can be basic, common, uncommon, rare or mythic

rulings

array(object)
{{link:rulings}}
See the {{link:rulings}} structure.

scryfallId

string
"80164e61-3e94-4e10-9bd1-518b8dc7fc4c"
A universal unique id (v4) generated by Scryfall. Note that cards with multiple faces are not unique.

scryfallOracleId

string
"9b7870df-6bca-499f-bc6e-e57f2ddfe640"
A unique ID for this card’s oracle identity. This value is consistent across reprinted card editions, and unique among different cards with the same name (tokens, Unstable variants, etc).

scryfallIllustrationId

string
"4ab49865-ff4c-4dae-94e8-a5ce273138da"
A unique identifier for the card artwork that remains consistent across reprints. Newly spoiled cards may not have this field yet.

side

string
"a"
Identifier of the side. Used on cards with multiple faces, such as {{code:flip}}, {{code:split}}, {{code:transform}} cards. Can be {{code:a}}, {{code:b}}, or {{code:c}}.

subtypes

array(string)
["Angel"]
List of card subtypes found after em-dash. ("Legendary Creature — Angel")

supertypes

array(string)
["Legendary"]
List of card supertypes found before em-dash. ("Legendary Creature — Angel")

tcgplayerProductId

integer
183201
Numeric identifier for the card for TCGPlayer.

tcgplayerPurchaseUrl

string
"https://mtgjson.com/links/c9231e9296c7917d"
URL which redirects to TCGPlayer website’s card page.

text

string
"Reach (This creature can block creatures with flying.)\nDeathtouch (Any amount of damage this deals to a creature is enough to destroy it.)"
Rules text of the card.

toughness

string
"4"
Toughness of the card.

type

string
"Legendary Creature — Angel"
Type of the card. Includes any supertypes and subtypes. ("Creature — Angel")

types

array(string)
["Creature"]
List of types of the card.

uuid

string
"7eb0f276-5e32-5a1e-acfd-9b0ddc19b845"
A universal unique id (v5) generated by MTGJSON. Each entry is unique.

variations

array(string)
["7eb0f276-5e32-5a1e-acfd-9b0ddc19b845"]
List of uuid id's of this card with alternate printings in the same set. Excludes Un-sets.

watermark

string
"wotc"
Name of the watermark on the card. If there isn’t one, it can be an empty string, but it is usually omitted.
Last Updated: 2019-04-23