Card

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

Parent property: cards
Parent property type: array(anonymous object)

Data Structure

Property Attributes

The property attributes you see below earmark possible conditions for a field in this data structure.

    Property Information

    Type

    string

    Introduced

    v4.0.0

    Example

    "Ryan Yee"

    Description

    Name of the artist that illustrated the card art.

    Type

    string

    Introduced

    v4.0.0

    Example

    "black"

    Description

    Color of the border. Can be black, borderless, gold, silver, or white.

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["B"]

    Description

    List of all colors in card’s mana cost, rules text and any color indicator.

    Attributes

    atomic

    Type

    array(string)

    Introduced

    v4.0.2

    Example

    ["B","R"]

    Description

    List of all colors in card's color indicator (The symbol showing the colors of the card).

    Attributes

    atomic
    optional

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["B","R"]

    Description

    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).

    Attributes

    atomic

    Type

    float

    Introduced

    v4.0.0

    Example

    5.0

    Description

    The converted mana cost of the card.

    Attributes

    atomic

    Type

    integer

    Introduced

    v4.4.1

    Example

    2

    Description

    How many of this card exists in a relevant deck.

    Attributes

    deck

    Type

    string

    Introduced

    v4.2.0

    Example

    "a"

    Description

    If the card is in a duel deck product, can be a(left) or b(right).

    Attributes

    optional

    Type

    integer

    Introduced

    v4.5.0

    Example

    1000

    Description

    Card rank on EDHRec.

    Attributes

    atomic
    optional

    Type

    float

    Introduced

    v4.1.1

    Example

    5.0

    Description

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

    Attributes

    atomic

    Type

    string

    Introduced

    v4.0.0

    Example

    "Whatever hatred destroys, a single act of trust can revive."

    Description

    Italicized text found below the rules text that has no game function.

    Attributes

    optional

    Type

    array(object)

    Introduced

    v4.0.0

    Description

    See the foreignData structure.

    Attributes

    atomic

    Type

    string

    Introduced

    v4.2.0

    Example

    "legendary"

    Description

    Values can be colorshifted, compasslanddfc, devoid, draft, legendary, miracle, mooneldrazidfc, nyxtouched, originpwdfc, sunmoondfc, or tombstone.

    Attributes

    deprecated

    Type

    array[string]

    Introduced

    v4.6.0

    Example

    "legendary"

    Description

    Values can be colorshifted, compasslanddfc, devoid, draft, legendary, miracle, mooneldrazidfc, nyxtouched, originpwdfc, sunmoondfc, or tombstone.

    Type

    string

    Introduced

    v4.0.0

    Example

    "2015"

    Description

    Version of the card frame style. Can be 1993, 1997, 2003, 2015, or future.

    Key

    Type

    string

    Introduced

    v4.2.1

    Example

    "+0"

    Description

    Starting maximum hand size total modifier. A plus or minus character preceeds an integer.

    Attributes

    atomic
    optional

    Type

    boolean

    Introduced

    v4.0.0

    Example

    true

    Description

    Can the card be found in foil?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.5.1

    Example

    true

    Description

    Does this card allow more than 4 copies in a deck?

    Attributes

    atomic
    optional
    deprecated

    Type

    boolean

    Introduced

    v4.0.0

    Example

    true

    Description

    Can the card be found in non-foil?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.2.0

    Example

    true

    Description

    The card has some kind of alternative variation to its printed counterpart.

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Is the card available in Magic: The Gathering Arena?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Is the card full artwork?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Is the card available in Magic: The Gathering Online?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.0.1

    Example

    true

    Description

    Is the card only available online?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.0.0

    Example

    true

    Description

    Is the card oversized?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Is the card available in print?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Is the card a promotional print?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Has the card been reprinted?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.0.1

    Example

    true

    Description

    Is the card on the MTG Reserved List?

    Attributes

    atomic
    optional

    Type

    boolean

    Introduced

    v4.0.0

    Example

    true

    Description

    Is this card found in a booster pack?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Does the card have a story spotlight?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Does the card normally have a text box, but doesn't on this card?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.1

    Example

    true

    Description

    Is this card "timeshifted"? (A feature from Time Spiral block)

    Attributes

    optional

    Type

    string

    Introduced

    v4.0.0

    Example

    "normal"

    Description

    Type of card layout. Can be normal, split, flip, transform, meld, leveler, saga, planar, scheme, vanguard, token, double_faced_token, emblem, augment, aftermath, or host.

    Attributes

    atomic

    Type

    array(string: string)

    Introduced

    v4.5.1

    Description

    See the leadershipSkills structure. Will be included only if one value is true.

    Attributes

    atomic
    optional

    Type

    object

    Introduced

    v4.0.0

    Example

    Description

    See the legalities structure.

    Attributes

    atomic

    Key

    Type

    string

    Introduced

    v4.2.1

    Example

    "+0"

    Description

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

    Attributes

    atomic
    optional

    Type

    string

    Introduced

    v4.0.0

    Example

    "7"

    Description

    Planeswalker loyalty value.

    Attributes

    atomic
    optional

    Type

    string

    Introduced

    v4.0.0

    Example

    "{3}{W}{W}"

    Description

    Mana cost of the card.

    Attributes

    atomic

    Type

    integer

    Introduced

    v4.4.0

    Example

    371878

    Description

    The Magic Card Market card ID.

    Type

    integer

    Introduced

    v4.4.0

    Example

    269313

    Description

    The Magic Card Market card meta ID.

    Type

    integer

    Introduced

    v4.5.0

    Example

    67330

    Description

    The Magic: The Gathering Arena card ID.

    Attributes

    optional

    Type

    integer

    Introduced

    v4.5.0

    Example

    34645

    Description

    The Magic: The Gathering Online card foil ID.

    Attributes

    optional

    Type

    integer

    Introduced

    v4.5.0

    Example

    34644

    Description

    The Magic: The Gathering Online card ID.

    Attributes

    optional

    Type

    integer

    Introduced

    v4.4.0

    Example

    40272

    Description

    mtgstocks.com card ID.

    Attributes

    atomic

    Type

    integer

    Introduced

    v4.0.0

    Example

    457145

    Description

    An integer most cards have which Wizards of the Coast uses as a card identifier.

    Key

    Type

    string

    Introduced

    v4.0.0

    Example

    "Angel of Grace"

    Description

    Names of each face on the card. Meld cards are listed in the order of CardA, Meld, CardB.

    Attributes

    atomic
    optional

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["Nicol Bolas, the Ravager","Nicol Bolas, the Arisen"]

    Description

    Names of each face on the card. Meld cards are listed in the order of CardA, Meld, CardB.

    Attributes

    atomic
    optional

    Type

    string

    Introduced

    v4.0.0

    Example

    "218"

    Description

    Number of the card.

    Type

    string

    Introduced

    v4.0.0

    Example

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

    Description

    Text on the card as originally printed.

    Type

    string

    Introduced

    v4.0.0

    Example

    "Legendary Creature — Angel"

    Description

    Type as originally printed. Includes any supertypes and subtypes.

    Type

    array(string)

    Introduced

    v4.7.0

    Example

    ["7eb0f276-5e32-5a1e-acfd-9b0ddc19b845"]

    Description

    List of uuid's of this card with counterparts, such as transformed or melded faces.

    Attributes

    optional

    Type

    string

    Introduced

    v4.0.0

    Example

    "5"

    Description

    Power of the creature.

    Attributes

    atomic

    Type

    object(string: object)

    Introduced

    v4.4.0

    Example

    Description

    See the prices structure.

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["M19","PM19"]

    Description

    List of sets the card was printed in, in uppercase.

    Attributes

    atomic

    Type

    array(string: string)

    Introduced

    v4.4.0

    Description

    See the purchaseUrls structure.

    Attributes

    atomic

    Type

    string

    Introduced

    v4.0.0

    Example

    "mythic"

    Description

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

    Type

    array(string)

    Example

    ["Ajani, Strength of the Pride", ...]

    Description

    The names of the cards that produce this token.

    Attributes

    optional
    token

    Type

    array(object)

    Introduced

    v4.0.0

    Example

    Description

    See the rulings structure.

    Attributes

    atomic

    Type

    string

    Introduced

    v4.0.0

    Example

    "80164e61-3e94-4e10-9bd1-518b8dc7fc4c"

    Description

    A universal unique ID (v4) generated by Scryfall. Note that cards with multiple faces are not unique.

    Type

    string

    Introduced

    v4.3.1

    Example

    "9b7870df-6bca-499f-bc6e-e57f2ddfe640"

    Description

    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).

    Attributes

    atomic

    Type

    string

    Introduced

    v4.3.1

    Example

    "4ab49865-ff4c-4dae-94e8-a5ce273138da"

    Description

    A unique identifier for the card artwork that remains consistent across reprints. Newly spoiled cards may not have this field yet.

    Attributes

    optional

    Key

    Type

    string

    Introduced

    v4.1.0

    Example

    "a"

    Description

    Identifier of the side. Used on cards with multiple faces, such as flip, split, transform cards. Can be a, b, or c.

    Attributes

    atomic
    optional

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["Angel"]

    Description

    List of card subtypes found after em-dash.

    Attributes

    atomic

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["Legendary"]

    Description

    List of card supertypes found before em-dash.

    Attributes

    atomic

    Type

    integer

    Introduced

    v4.2.1

    Example

    183201

    Description

    Numeric identifier for the card for TCGPlayer.

    Key

    Type

    string

    Introduced

    v4.0.0

    Example

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

    Description

    Rules text of the card.

    Attributes

    atomic

    Type

    string

    Introduced

    v4.0.0

    Example

    "4"

    Description

    Toughness of the card.

    Attributes

    atomic

    Key

    Type

    string

    Introduced

    v4.0.0

    Example

    "Legendary Creature — Angel"

    Description

    Type of the card. Includes any supertypes and subtypes.

    Attributes

    atomic

    Type

    array(string)

    Introduced

    v4.0.0

    Example

    ["Lengendary", "Creature", "Angel"]

    Description

    List of all types of the card.

    Attributes

    atomic

    Key

    Type

    string

    Introduced

    v4.0.0

    Example

    "7eb0f276-5e32-5a1e-acfd-9b0ddc19b845"

    Description

    A universal unique ID (v5) generated by MTGJSON. Each entry is unique.

    Attributes

    atomic

    Type

    array(string)

    Introduced

    v4.1.2

    Example

    ["7eb0f276-5e32-5a1e-acfd-9b0ddc19b845"]

    Description

    List of uuid id's of this card with alternate printings in the same set. Excludes Un-sets.

    Type

    string

    Introduced

    v4.0.0

    Example

    "wotc"

    Description

    Name of the watermark on the card.

    Attributes

    optional
    Last Updated: 2019-12-01