Card Objects

Card objects represent individual Magic: The Gathering cards that players could obtain and add to their collection (with a few minor exceptions).

Cards are the API’s most complex object. You are encouraged to throughly read this document and also the article about layouts and images.

Card Names

Internally, Scryfall tracks the uniqueness of “Oracle names” (i.e. names you can pick when an effect asks you to “choose a card name”). Each unique Oracle name is separately available in the card names catalog.

Note that while every Oracle card name is unique, Scryfall also indexes other objects such as tokens which do not always have a unique name.

Cards (that are not tokens) with the same name field are interchangeable gameplay objects (according to the rules) and they will share the same gameplay fields, detailed below.

Multiface Cards

Magic cards can have multiple faces. The faces could be shown divided on the front of the card as in split cards and flip cards, or the card can be double-sided as in transform cards and double-sided tokens.

Scryfall represents multiface cards as a single object with a card_faces array describing the distinct faces.

Core Card Fields

Cards have the following core properties:

Property Type Atn Details
id UUID A unique ID for this card in Scryfall’s database.
multiverse_ids Array Nullable This card’s multiverse IDs on Gatherer, if any, as an array of integers. Note that Scryfall includes many promo cards, tokens, and other esoteric objects that do not have these identifiers.
mtgo_id Integer Nullable This card’s Magic Online ID (also known as the CatID), if any. A large percentage of cards are not available on Magic Online and do not have this ID.
uri URI A link to this card object on Scryfall’s API.
scryfall_uri URI A link to this card’s permapage on Scryfall’s website.
prints_search_uri URI A link to where you can begin paginating all re/prints for this card on Scryfall’s API.

Gameplay Fields

Cards have the following properties relevant to the game rules:

Property Type Atn Details
name String The name of this card. If this card has multiple faces, this field will contain both names separated by ␣//␣.
layout String A computer-readable designation for this card’s layout. See the layout article.
cmc Decimal The card’s converted mana cost. Note that some funny cards have fractional mana costs.
type_line String The type line of this card.
oracle_text String Nullable The Oracle text for this card, if any.
mana_cost String The mana cost for this card. This value will be any empty string "" if the cost is absent. Remember that per the game rules, a missing mana cost and a mana cost of {0} are different values.
power String Nullable This card’s power, if any. Note that some cards have powers that are not numeric, such as *.
toughness String Nullable This card’s toughness, if any. Note that some cards have toughnesses that are not numeric, such as *.
loyalty String Nullable This loyalty if any. Note that some cards have loyalties that are not numeric, such as X.
life_modifier String Nullable This card’s life modifier, if it is Vanguard card. This value will contain a delta, such as +2.
hand_modifier String Nullable This card’s hand modifier, if it is Vanguard card. This value will contain a delta, such as -1.
colors Colors This card’s colors.
color_indicator Colors Nullable The colors in this card’s color indicator, if any. A null value for this field indicates the card does not have one.
color_identity Colors This card’s color identity.
all_parts Array Nullable If this card is closely related to other cards, this property will be an array with.
card_faces Array Nullable An array of Card Face objects, if this card is multifaced.
legalities Object An object describing the legality of this card.
reserved Boolean True if this card is on the Reserved List.
edhrec_rank Integer Nullable This card’s overall rank/popularity on EDHREC. Not all carsd are ranked.

Cards have the following properties unique to their particular re/print:

Property Type Atn Details
set String This card’s set code.
set_name String This card’s full set name.
collector_number String This card’s collector number. Note that collector numbers can contain non-numeric characters, such as letters or .
set_setch_uri URI A link to where you can begin paginating this card’s set on the Scryfall API.
scryfall_set_uri URI A link to this card’s set on Scryfall’s website.
image_uris Object Nullable An object listing available imagery for this card. See the [Card Imagery](#) article for more information.
highres_image Boolean True if this card’s imagery is high resolution.
reprint Boolean True if this card is a reprint.
digital Boolean True if this is a digital card on Magic Online.
rarity String This card’s rarity.
flavor_text String Nullable The flavor text, if any.
artist String Nullable The name of the illustrator of this card. Newly spoiled cards may not have this field yet.
frame String This card’s frame layout. See.
full_art Boolean True if this card’s artwork is larger than normal.
watermark String Nullable This card’s watermark, if any.
border_color String This card’s border color: black, gold, silver, or white.
story_spotlight_number Integer Nullable This card’s story spotlight number, if any.
story_spotlight_uri URI Nullable A URL to this cards’s story article, if any.
timeshifted Boolean True if this card is timeshifted.
colorshifted Boolean Ture if this card is colorshifted.
futureshifted Boolean True if this card is from the future.

Card Face Objects

Multiface cards have a card_faces property containing at least two Card Face objects. Those objects have the following properties:

Property Type Atn Details
name String The name of this particular face.
type_line String The type line of this particular face.
oracle_text String Nullable The Oracle text for this face, if any.
mana_cost String The mana cost for this face. This value will be any empty string "" if the cost is absent. Remember that per the game rules, a missing mana cost and a mana cost of {0} are different values.
colors Colors This face’s colors.
color_indicator Colors Nullable The colors in this face’s color indicator, if any.
power String Nullable This face’s power, if any. Note that some cards have powers that are not numeric, such as *.
toughness String Nullable This face’s toughness, if any.
loyalty String Nullable This face’s loyalty, if any.
flavor_text String Nullable The flavor text printed on this face, if any.
image_uris Object Nullable An object providing URIs to imagery for this face, if this is a double-sided card. If this card is not double-sided, then the image_uris property will be part of the parent object instead.

Cards that are closely related to other cards (because they call them by name, or generate a token, or meld, etc) have a related_cards property that contains Related Card objects. Those objects have the following properties:

Property Type Atn Details
id UUID An unique ID for this card in Scryfall’s database.
name String The name of this particular related card.
uri URI A URI where you can retrieve a full object describing this card on Scryfall’s API.