# Card (Set)
The Card (Set) Data Model describes the properties of a single card in a set.
Parent model: Set
Parent property: cards
# Model Index
- artist
- asciiName
- availability
- boosterTypes
- borderColor
- cardParts
- colorIdentity
- colorIndicator
- colors
- convertedManaCost
- edhrecRank
- faceConvertedManaCost
- faceFlavorName
- faceManaValue
- faceName
- finishes
- flavorName
- flavorText
- foreignData
- frameEffects
- frameVersion
- hand
- hasAlternativeDeckLimit
- hasContentWarning
- hasFoil
- hasNonFoil
- identifiers
- isAlternative
- isFullArt
- isFunny
- isOnlineOnly
- isOversized
- isPromo
- isRebalanced
- isReprint
- isReserved
- isStarter
- isStorySpotlight
- isTextless
- isTimeshifted
- keywords
- language
- layout
- leadershipSkills
- legalities
- life
- loyalty
- manaCost
- manaValue
- name
- number
- originalPrintings
- originalReleaseDate
- originalText
- originalType
- otherFaceIds
- power
- printings
- promoTypes
- purchaseUrls
- rarity
- rebalancedPrintings
- rulings
- securityStamp
- setCode
- side
- signature
- subtypes
- supertypes
- text
- toughness
- type
- types
- uuid
- variations
- watermark
# Model Properties
# artist
The name of the artist that illustrated the card art.
- Type:
string
- Introduced:
v4.0.0
- Tags: Optional
# asciiName
The ASCII (opens new window) (Basic/128) code formatted card name with no special unicode characters.
- Type:
string
- Introduced:
v5.0.0
- Tags: Optional
# availability
A list of the card's available printing types.
- Type:
array[string]
- Introduced:
v5.0.0
# boosterTypes
A list of types this card is in a booster pack.
- Type:
array[string]
- Introduced:
v5.2.1
- Tags: OptionalNewPreview v5.2.1
# borderColor
The color of the card border.
- Type:
string
- Introduced:
v4.0.0
# cardParts
A list of card names associated to this card, such as
"Meld"
card face names.
- Type:
array[string]
- Introduced:
v5.2.0
- Tags: OptionalNew
# colorIdentity
A list of all the colors found in
manaCost
,colorIndicator
, andtext
.
- 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
- Tags: Optional
# colors
A list of all the colors in
manaCost
andcolorIndicator
. Some cards may not have values, such as cards with"Devoid"
in its text.
- Type:
array[] || array[string]
- Introduced:
v4.0.0
# convertedManaCost
The converted mana cost of the card. Use the manaValue property.
- Type:
float
- Introduced:
v4.0.0
- Tags: Deprecated
# edhrecRank
The card rank on EDHRec (opens new window).
- Type:
integer
- Introduced:
v4.5.0
- Tags: Optional
# faceConvertedManaCost
The converted mana cost or mana value for the face for either half or part of the card. Use the faceManaValue property.
- Type:
float
- Introduced:
v4.1.1
- Tags: OptionalDeprecated
# faceFlavorName
The flavor name on the face of the card.
- Type:
string
- Introduced:
v5.2.0
- Tags: OptionalNew
# faceManaValue
The mana value of the face for either half or part of the card. Formally known as "converted mana cost".
- Type:
float
- Introduced:
v5.2.0
- Tags: OptionalNew
# faceName
The name on the face of the card.
- Type:
string
- Introduced:
v5.0.0
- Tags: Optional
# finishes
The finishes of the card.
- Type:
array[] || array[string]
- Introduced:
v5.2.0
- Tags: New
# 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
- Tags: Optional
# flavorText
The italicized text found below the rules text that has no game function.
- Type:
string
- Introduced:
v4.0.0
- Tags: 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 effects.
- Type:
array[string]
- Introduced:
v4.6.0
- Tags: Optional
# 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
- Tags: Optional
# hasAlternativeDeckLimit
If the card allows a value other than 4 copies in a deck.
- Type:
boolean
- Introduced:
v5.0.0
- Tags: 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
- Tags: Optional
# hasFoil
If the card can be found in foil. Use the finishes property.
- Type:
boolean
- Introduced:
v4.0.0
- Tags: Deprecated
# hasNonFoil
If the card can be found in non-foil. Use the finishes property.
- Type:
boolean
- Introduced:
v4.0.0
- Tags: Deprecated
# 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 is an alternate variation to an original printing.
- Type:
boolean
- Introduced:
v4.2.0
- Tags: Optional
# isFullArt
If the card has full artwork.
- Type:
boolean
- Introduced:
v4.4.2
- Tags: Optional
# isFunny
If the card is part of a funny set.
- Type:
boolean
- Introduced:
v5.2.0
- Tags: OptionalNew
# isOnlineOnly
If the card is only available in online game variations.
- Type:
boolean
- Introduced:
v4.0.1
- Tags: Optional
# isOversized
If the card is oversized.
- Type:
boolean
- Introduced:
v4.0.0
- Tags: Optional
# isPromo
If the card is a promotional printing.
- Type:
boolean
- Introduced:
v4.4.2
- Tags: Optional
# isRebalanced
If the card is rebalanced (opens new window) for the Alchemy (opens new window) play format.
- Type:
boolean
- Introduced:
v5.2.0
- Tags: OptionalNew
# isReprint
If the card has been reprinted.
- Type:
boolean
- Introduced:
v4.4.2
- Tags: Optional
# isReserved
If the card is on the Magic: The Gathering Reserved List (opens new window).
- Type:
boolean
- Introduced:
v4.0.1
- Tags: Optional
# isStarter
If the card is found in a starter deck such as Planeswalker/Brawl decks.
- Type:
boolean
- Introduced:
v4.0.0
- Tags: Optional
# isStorySpotlight
If the card is a Story Spotlight (opens new window) card.
- Type:
boolean
- Introduced:
v4.4.2
- Tags: Optional
# isTextless
If the card does not have a text box.
- Type:
boolean
- Introduced:
v4.4.2
- Tags: Optional
# isTimeshifted
If the card is "timeshifted", a feature of certain sets where a card will have a different frameVersion.
- Type:
boolean
- Introduced:
v4.4.1
- Tags: Optional
# keywords
A list of keywords found on the card.
- Type:
array[string]
- Introduced:
v5.0.0
- Tags: Optional
# language
The language the card is printed in.
- Type:
string
- Introduced:
v5.2.1
- Tags: NewPreview v5.2.1
# 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
- Tags: 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
- Tags: Optional
# loyalty
The starting loyalty value of the card. Used only on cards with
"Planeswalker"
in its types.
- Type:
string
- Introduced:
v4.0.0
- Tags: Optional
# manaCost
The mana cost of the card wrapped in brackets for each value.
- Type:
string
- Example:
"{1}{B}"
- Introduced:
v4.0.0
- Tags: Optional
# manaValue
The mana value of the card. Formally known as "converted mana cost".
- Type:
float
- Introduced:
v5.2.0
- Tags: New
# name
The name of the card. Cards with multiple faces, like
"Split"
and"Meld"
cards are given a delimiter of//
.
- 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 promotional sets.
- Type:
string
- Introduced:
v4.0.0
# originalPrintings
A list of card UUID's to original printings of the card if this card is somehow different from its original, such as rebalanced (opens new window) cards.
- Type:
array[string]
- Introduced:
v5.2.0
- Tags: OptionalNew
# 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
- Tags: Optional
# originalText
The text on the card as originally printed.
- Type:
string
- Introduced:
v4.0.0
- Tags: Optional
# originalType
The type of the card as originally printed. Includes any supertypes and subtypes.
- Type:
string
- Introduced:
v4.0.0
- Tags: Optional
# otherFaceIds
A list of card UUID's to this card's counterparts, such as transformed or melded faces.
- Type:
array[string]
- Introduced:
v4.6.1
- Tags: Optional
# power
The power of the card.
- Type:
string
- Introduced:
v4.0.0
- Tags: Optional
# printings
A list of set printing codes the card was printed in, formatted in uppercase.
- Type:
array[string]
- Introduced:
v4.0.0
- Tags: Optional
# promoTypes
A list of promotional types for a card.
- Type:
array[string]
- Introduced:
v5.0.0
- Tags: 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. Rarity
bonus
relates to cards that have an alternate availability in booster packs, whilespecial
relates to "Timeshifted" cards.
- Type:
string
- Introduced:
v4.0.0
# rebalancedPrintings
A list of card UUID's to printings that are rebalanced (opens new window) versions of this card.
- Type:
array[string]
- Introduced:
v5.2.0
- Tags: OptionalNew
# rulings
The official rulings of the card. See the Rulings Data Model.
- Type:
array[] || array[object]
- Introduced:
v4.0.0
# securityStamp
The security stamp printed on the card.
- Type:
string
- Introduced:
v5.2.0
- Tags: OptionalNew
# setCode
The set printing code that the card is from.
- Type:
string
- Introduced:
v5.0.1
# side
The identifier of the card side. Used on cards with multiple faces on the same card.
- Type:
string
- Introduced:
v4.1.0
- Tags: Optional
# signature
The name of the signature on the card.
- Type:
string
- Introduced:
v5.2.0
- Tags: OptionalNew
# 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
- Tags: Optional
# toughness
The toughness of the card.
- Type:
string
- Introduced:
v4.0.0
- Tags: 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 card 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
- Tags: Optional