MTGJSON

# 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

# 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, 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
  • Tags: Optional

# colors

A list of all the colors in manaCost and colorIndicator. 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, while special 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