Card (Token) #

The Card (Token) Data Model describes the properties of a single token card.

• Parent model: Set
• Parent property: tokens

Model Type #

type CardToken = {
  artist?: string;
  asciiName?: string;
  availability: string[];
  boosterTypes?: string[];
  borderColor: string;
  cardParts?: string[];
  colorIdentity: string[];
  colorIndicator?: string[];
  colors: string[];
  faceName?: string;
  faceFlavorName?: string;
  finishes: string[];
  flavorText?: string;
  frameEffects?: string[];
  frameVersion: string;
  hasFoil: boolean;
  hasNonFoil: boolean;
  identifiers: Identifiers;
  isFullArt?: boolean;
  isFunny?: boolean;
  isOnlineOnly?: boolean;
  isPromo?: boolean;
  isReprint?: boolean;
  keywords?: string[];
  language: string;
  layout: string;
  loyalty?: string;
  name: string;
  number: string;
  otherFaceIds?: string[];
  power?: string;
  promoTypes?: string[];
  relatedCards: RelatedCards;
  reverseRelated?: string[];
  securityStamp?: string;
  setCode: string;
  side?: string;
  signature?: string;
  subsets?: string[];
  subtypes: string[];
  supertypes: string[];
  text?: string;
  toughness?: string;
  type: string;
  types: string[];
  uuid: string;
  watermark?: string;
}

Model Index #

Model Properties #

artist #

The name of the artist that illustrated the card art.

• Type: string
• Introduced: v4.0.0

asciiName #

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

• Type: string
• Introduced: v5.0.0

availability #

A list of the card's available printing types.

• Type: string[]
• Example: "arena", "dreamcast", "mtgo", "paper", "shandalar"
• Introduced: v5.0.0

boosterTypes #

A list of types this card is in a booster pack.

• Type: string[]
• Example: "deck", "default"
• Introduced: v5.2.1

borderColor #

The color of the card border.

• Type: string
• Example: "black", "borderless", "gold", "silver", "white"

  Show More
• Introduced: v4.0.0

cardParts #

A list of card names associated to this card, such as "Meld" card face names.

• Type: string[]
• Introduced: v5.2.0

colorIdentity #

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

• Type: string[]
• Example: "B", "G", "R", "U", "W"
• Introduced: v4.0.0

colorIndicator #

A list of all the colors in the color indicator. This is the symbol prefixed to a card's types.

• Type: string[]
• Example: "B", "G", "R", "U", "W"
• Introduced: v4.0.2

colors #

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

• Type: string[]
• Example: "B", "G", "R", "U", "W"
• Introduced: v4.0.0

faceName #

The name on the face of the card.

• Type: string
• Introduced: v5.0.0

faceFlavorName #

The flavor name on the face of the card.

• Type: string
• Introduced: v5.2.0

finishes #

The finishes of the card.

• Type: string[]
• Example: "etched", "foil", "nonfoil", "signed"
• Introduced: v5.2.0

flavorText #

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

• Type: string
• Introduced: v4.0.0

frameEffects #

The visual frame effects.

• Type: string[]
• Example: "boosterfun", "colorshifted", "companion", "compasslanddfc", "convertdfc"

  Show More
• Introduced: v4.6.0

frameVersion #

The version of the card frame style.

• Type: string
• Example: "1993", "1997", "2003", "2015", "future"
• Introduced: v4.0.0

hasFoil #

If the card can be found in foil.

This property is deprecated. Use the finishes property instead.

• Type: boolean
• Introduced: v4.0.0

hasNonFoil #

If the card can be found in non-foil.

This property is deprecated. Use the finishes property instead.

• Type: boolean
• Introduced: v4.0.0

identifiers #

The identifiers associated to a card. See the Identifiers Data Model.

• Type: Identifiers
• Introduced: v5.0.0

isFullArt #

If the card has full artwork.

• Type: boolean
• Introduced: v4.4.2

isFunny #

If the card is part of a funny set, such as an Un-set.

• Type: boolean
• Introduced: v5.2.0

isOnlineOnly #

If the card is only available in online game play variations.

• Type: boolean
• Introduced: v4.0.1

isPromo #

If the card is a promotional printing.

• Type: boolean
• Introduced: v4.4.2

isReprint #

If the card has been reprinted.

• Type: boolean
• Introduced: v4.4.2

keywords #

A list of keywords found on the card.

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

language #

The language the card is printed in.

• Type: string
• Example: "Ancient Greek", "Arabic", "Chinese Simplified", "Chinese Traditional", "English"

  Show More
• Introduced: v5.2.1

layout #

The type of card layout. For a Card (Token), this will only ever be "token".

• Type: string
• Example: "adventure", "aftermath", "art_series", "augment", "case"

  Show More
• Introduced: v4.0.0

loyalty #

The starting loyalty value of the card. Used only on cards with "Planeswalker" in its types.

• Type: string
• Introduced: v4.0.0

name #

The name of the card. Cards with multiple faces are given a // delimiter.

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

number #

The number of the card. Cards can have a variety of numbers, letters and/or symbols for promotional qualities.

• Type: string
• Introduced: v4.0.0

otherFaceIds #

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

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

power #

The power of the card.

• Type: string
• Introduced: v4.0.0

promoTypes #

A list of promotional types for a card.

• Type: string[]
• Example: "alchemy", "arenaleague", "beginnerbox", "boosterfun", "boxtopper"

  Show More
• Introduced: v5.0.0

relatedCards #

The related cards for this card. See the Related Cards Data Model.

• Type: RelatedCards
• Introduced: v5.2.1

reverseRelated #

The names of the cards that produce this card.

This property is deprecated. Use the relatedCards property instead.

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

securityStamp #

The security stamp printed on the card.

• Type: string
• Example: "acorn", "arena", "circle", "heart", "oval"

  Show More
• Introduced: v5.2.0

setCode #

The printing set 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
• Example: "a", "b", "c", "d", "e"
• Introduced: v4.1.0

signature #

The name of the signature on the card.

• Type: string
• Introduced: v5.2.0

subsets #

The names of the subset printings a card is in. Used primarily on "Secret Lair Drop" cards.

• Type: string[]
• Introduced: v5.2.1

subtypes #

A list of card subtypes found after em-dash.

• Type: string[]
• Example: "Abian", "Adventure", "Advisor", "Aetherborn", "Ajani"

  Show More
• Introduced: v4.0.0

supertypes #

A list of card supertypes found before em-dash.

• Type: string[]
• Example: "Basic", "Host", "Legendary", "Ongoing", "Snow"

  Show More
• Introduced: v4.0.0

text #

The rules text of the card.

• Type: string
• Introduced: v4.0.0

toughness #

The toughness of the card.

• Type: string
• Introduced: v4.0.0

type #

The type of the card as visible, including any supertypes and subtypes and are given a - delimiter if appropriate.

• Type: string
• Introduced: v4.0.0

types #

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

• Type: string[]
• Example: "Artifact", "Battle", "Boss", "Card", "Conspiracy"

  Show More
• Introduced: v4.0.0

uuid #

The universal unique identifier (v5) generated by MTGJSON.

• Type: string
• Introduced: v4.0.0

watermark #

The name of the watermark on the card.

• Type: string
• Example: "abzan", "agentsofsneak", "airnomads", "arena", "atarka"

  Show More
• Introduced: v4.0.0