MTGJSON

# Card (Atomic)

The Card (Atomic) Data Model describes a single atomic card, an oracle-like entity of a Magic: The Gathering card that only stores evergreen data about a card that would never change from printing to printing.

Parent file: AtomicCards, LegacyAtomic, ModernAtomic, PauperAtomic, PioneerAtomic, StandardAtomic, VintageAtomic
Parent property: data

The Card (Atomic) Data Model is accessed through an array of card variations where its parent property is the name of the card, like such:

"data": {
  "Oblivion Ring": [
    <Card (Atomic) Model>,
    ...
  ],
  ...
}

# Model Index

# Model Properties

# 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

# 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

# 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

# foreignData

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

  • Type: array[] || array[object]
  • 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

# identifiers

A list of identifiers associated to a card. See the Identifiers Data Model.

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

# isFunny

If the card is part of a funny set.

  • Type: boolean
  • Introduced: v5.2.0
  • Tags: OptionalNew

# isReserved

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

  • Type: boolean
  • Introduced: v4.0.1
  • Tags: Optional

# keywords

A list of keywords found on the card.

  • Type: array[string]
  • Introduced: v5.1.0
  • Tags: 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
  • 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.

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

# 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

# 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

# rulings

The official rulings of the card. See the Rulings Data Model.

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

# 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

# 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

The 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