# Card (Atomic)

The Card (Atomic) file model describes the 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

Card (Atomic) objects are accessed from a single index array with the property name being the card's name.

Example:

{
  "data": {
    "Dark Ritual": [
      <Card (Atomic) Model>
    ],
    ... // More cards
  },
  "meta": <Meta 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
  • Attributes: 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
  • 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

# 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
  • Attributes: optional

# hasAlternativeDeckLimit

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

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

# identifiers

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

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

# isReserved

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

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

# keywords

A list of keywords found on the card.

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

# 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

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

  • 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

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