MTGJSON

# Card (Set)

The Card (Set) data model describes the properties of a single card.

Parent model: Set
Parent property: cards

# Model Index

# Model Properties

# artist

The name of the artist that illustrated the card art.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# asciiName

The ASCII (opens new window) (Basic/128) code formatted card name with no special unicode characters.

  • Type: string
  • Introduced: v5.0.0
  • Attributes: optional

# availability

A list of the card's available printing types.

  • Type: array[string]
  • Introduced: v5.0.0

# borderColor

The color of the card border.

  • Type: string
  • Introduced: v4.0.0

# colorIdentity

A list of all the colors found in manaCost, colorIndicator, and text.

  • Type: array[] | array[string]
  • Introduced: v4.0.0

# colorIndicator

A list of all the colors in the color indicator (The symbol prefixed to a card's types).

  • Type: array[string]
  • Introduced: v4.0.2
  • Attributes: optional

# colors

A list of all the colors in manaCost and colorIndicator. Some cards may not have a value, such as cards with "Devoid" in its text.

  • Type: array[] | array[string]
  • Introduced: v4.0.0

# convertedManaCost

The converted mana cost of the card.

  • Type: float
  • Introduced: v4.0.0

# edhrecRank

The card rank on EDHRec (opens new window).

  • Type: integer
  • Introduced: v4.5.0
  • Attributes: optional

# faceConvertedManaCost

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

  • Type: float
  • Introduced: v4.1.1
  • Attributes: optional

# faceName

The name on the face of the card.

  • Type: string
  • Introduced: v5.0.0
  • Attributes: optional

# flavorName

The promotional card name printed above the true card name on special cards that has no game function. See this card (opens new window) for an example.

  • Type: string
  • Introduced: v5.0.0
  • Attributes: optional

# flavorText

The italicized text found below the rules text that has no game function.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# foreignData

A list of data properties in other languages. See the Foreign Data data model.

  • Type: array[] | array[object]
  • Introduced: v4.0.0

# frameEffects

The visual frame effect.

  • Type: array[] | array[string]
  • Introduced: v4.6.0

# frameVersion

The version of the card frame style.

  • Type: string
  • Introduced: v4.0.0

# hand

The starting maximum hand size total modifier. A + or - character precedes an integer.

  • Type: string
  • Introduced: v4.2.1
  • Attributes: optional

# hasContentWarning

If the card marked by Wizards of the Coast (opens new window) for having sensitive content. Cards with this property may have missing or degraded properties and values. See this official article (opens new window) for more information.

  • Type: boolean
  • Introduced: v5.0.0
  • Attributes: optional

# hasFoil

If the card be found in foil.

  • Type: boolean
  • Introduced: v4.0.0

# hasAlternativeDeckLimit

If the card allows a value other than 4 copies in a deck.

  • Type: boolean
  • Introduced: v5.0.0
  • Attributes: optional

# hasNonFoil

If the card can be found in non-foil.

  • Type: boolean
  • Introduced: v4.0.0

# identifiers

A list of identifiers associated to a card. See the Identifiers data model.

  • Type: object{props}
  • Introduced: v5.0.0

# isAlternative

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

  • Type: boolean
  • Introduced: v4.2.0
  • Attributes: optional

# isFullArt

If the card has full artwork.

  • Type: boolean
  • Introduced: v4.4.2
  • Attributes: optional

# isOnlineOnly

If the card is only available in Magic: The Gathering Online (opens new window).

  • Type: boolean
  • Introduced: v4.0.1
  • Attributes: optional

# isOversized

If the card is oversized.

  • Type: boolean
  • Introduced: v4.0.0
  • Attributes: optional

# isPromo

If the card is promotional.

  • Type: boolean
  • Introduced: v4.4.2
  • Attributes: optional

# isReprint

If the card has been reprinted.

  • Type: boolean
  • Introduced: v4.4.2
  • Attributes: optional

# isReserved

If the card is on the Magic: The Gathering Reserved List (opens new window).

  • Type: boolean
  • Introduced: v4.0.1
  • Attributes: optional

# isStarter

If this card is found in a booster pack.

  • Type: boolean
  • Introduced: v4.0.0
  • Attributes: optional

# isStorySpotlight

If the card has a story spotlight.

  • Type: boolean
  • Introduced: v4.4.2
  • Attributes: optional

# isTextless

If the card does not have a text box.

  • Type: boolean
  • Introduced: v4.4.2
  • Attributes: optional

# isTimeshifted

If this card is "timeshifted", a feature from Time Spiral block.

  • Type: boolean
  • Introduced: v4.4.1
  • Attributes: optional

# keywords

A list of keywords found on the card.

  • Type: array[string]
  • Introduced: v5.0.0
  • Attributes: optional

# layout

The type of card layout. For a token card, this will be "token".

  • Type: string
  • Introduced: v4.0.0

# leadershipSkills

A list of formats the card is legal to be a commander in. See the Leadership Skills data model.

  • Type: object{props}
  • Introduced: v4.5.1
  • Attributes: optional

# legalities

A list of play formats the card the card is legal in. See the Legalities data model.

  • Type: object{} | object{props}
  • Introduced: v4.0.0

# life

The starting life total modifier. A plus or minus character precedes an integer. Used only on cards with "Vanguard" in its types.

  • Type: string
  • Introduced: v4.2.1
  • Attributes: optional

# loyalty

The loyalty value of the card. Used on Planeswalker cards.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# manaCost

The mana cost of the card.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# name

The name of the card. Cards with multiple faces, like "Split" and "Meld" cards are given a delimiter.

  • Type: string
  • Example: "Wear // Tear"
  • Introduced: v4.0.0

# number

The number of the card. Can be prefixed or suffixed with a * or other characters for promo sets.

  • Type: string
  • Introduced: v4.0.0

# originalReleaseDate

The original release date in ISO 8601 (opens new window) format for a promotional card printed outside of a cycle window, such as Secret Lair Drop promotions.

  • Type: string
  • Introduced: v5.1.0
  • Attributes: optional

# originalText

The text on the card as originally printed.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# originalType

The type of the card as originally printed. Includes any supertypes and subtypes.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# otherFaceIds

A list of UUID's of this card with counterparts, such as transformed or melded faces.

  • Type: array[] | array[string]
  • Introduced: v4.6.1

# power

The power of the card.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# printings

A list of set codes the card was printed in, formatted in uppercase.

  • Type: array[string]
  • Introduced: v4.0.0
  • Attributes: optional

# promoTypes

A list of promotional types for a card.

  • Type: array[string]
  • Introduced: v5.0.0
  • Attributes: optional

# purchaseUrls

Links that navigate to websites where the card can be purchased. See the Purchase Urls data model.

  • Type: object{props}
  • Introduced: v4.4.0

# rarity

The card printing rarity.

  • Type: string
  • Introduced: v4.0.0

# rulings

The official rulings of the card. See the Rulings data model.

  • Type: array[] | array[object]
  • Introduced: v4.0.0

# setCode

The set code of the card.

  • Type: string
  • Introduced: v5.0.1

# side

The identifier of the card side. Used on cards with multiple faces.

  • Type: string
  • Introduced: v4.1.0
  • Attributes: optional

# subtypes

A list of card subtypes found after em-dash.

  • Type: array[] | array[string]
  • Introduced: v4.0.0

# supertypes

A list of card supertypes found before em-dash.

  • Type: array[] | array[string]
  • Introduced: v4.0.0

# text

The rules text of the card.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# toughness

The toughness of the card.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# type

Type of the card as visible, including any supertypes and subtypes.

  • Type: string
  • Introduced: v4.0.0

# types

A list of all card types of the card, including Un‑sets and gameplay variants.

  • Type: array[string]
  • Introduced: v4.0.0

# uuid

The universal unique identifier (v5) generated by MTGJSON. Each entry is unique.

  • Type: string
  • Introduced: v4.0.0

# variations

A list of UUID's of this card with alternate printings in the same set. Excludes Un‑sets.

  • Type: array[] | array[string]
  • Introduced: v4.1.2

# watermark

The name of the watermark on the card.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional