Scryfall · Schema
Scryfall Card
A single Magic: The Gathering card printing as returned by the Scryfall API. Card objects represent individual printings of cards in Magic, identified by a Scryfall ID and grouped by oracle_id across reprints.
Games And ComicsMagic The GatheringCard DataOpen DataFreeCommunity FundedPublic APIs
Properties
| Name | Type | Description |
|---|---|---|
| object | string | |
| id | string | A unique ID for this card in Scryfall's database. |
| oracle_id | string | A unique ID for this card's oracle identity, shared across reprints. |
| multiverse_ids | array | |
| mtgo_id | integer | |
| mtgo_foil_id | integer | |
| arena_id | integer | |
| tcgplayer_id | integer | |
| cardmarket_id | integer | |
| name | string | The name of this card. Multi-face cards use '//' to join face names. |
| lang | string | A language code for this printing. |
| released_at | string | |
| uri | string | |
| scryfall_uri | string | |
| layout | string | The card layout (normal, split, flip, transform, modal_dfc, meld, saga, etc.). |
| highres_image | boolean | |
| image_status | string | |
| image_uris | object | |
| mana_cost | string | |
| cmc | number | |
| type_line | string | |
| oracle_text | string | |
| colors | array | |
| color_identity | array | |
| keywords | array | |
| legalities | object | |
| games | array | |
| reserved | boolean | |
| foil | boolean | |
| nonfoil | boolean | |
| finishes | array | |
| oversized | boolean | |
| promo | boolean | |
| reprint | boolean | |
| variation | boolean | |
| set_id | string | |
| set | string | |
| set_name | string | |
| set_type | string | |
| collector_number | string | |
| digital | boolean | |
| rarity | string | |
| flavor_text | string | |
| artist | string | |
| artist_ids | array | |
| illustration_id | string | |
| border_color | string | |
| frame | string | |
| frame_effects | array | |
| security_stamp | string | |
| full_art | boolean | |
| textless | boolean | |
| booster | boolean | |
| story_spotlight | boolean | |
| edhrec_rank | integer | |
| penny_rank | integer | |
| prices | object | |
| related_uris | object | |
| purchase_uris | object | |
| all_parts | array | |
| card_faces | array | |
| power | string | |
| toughness | string | |
| loyalty | string | |
| defense | string | |
| produced_mana | array | |
| watermark | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/scryfall/main/json-schema/scryfall-card-schema.json",
"title": "Scryfall Card",
"description": "A single Magic: The Gathering card printing as returned by the Scryfall API. Card objects represent individual printings of cards in Magic, identified by a Scryfall ID and grouped by oracle_id across reprints.",
"type": "object",
"required": ["object", "id", "name", "lang", "layout", "type_line"],
"properties": {
"object": { "type": "string", "const": "card" },
"id": { "type": "string", "format": "uuid", "description": "A unique ID for this card in Scryfall's database." },
"oracle_id": { "type": "string", "format": "uuid", "description": "A unique ID for this card's oracle identity, shared across reprints." },
"multiverse_ids": { "type": "array", "items": { "type": "integer" } },
"mtgo_id": { "type": "integer" },
"mtgo_foil_id": { "type": "integer" },
"arena_id": { "type": "integer" },
"tcgplayer_id": { "type": "integer" },
"cardmarket_id": { "type": "integer" },
"name": { "type": "string", "description": "The name of this card. Multi-face cards use '//' to join face names." },
"lang": { "type": "string", "description": "A language code for this printing." },
"released_at": { "type": "string", "format": "date" },
"uri": { "type": "string", "format": "uri" },
"scryfall_uri": { "type": "string", "format": "uri" },
"layout": { "type": "string", "description": "The card layout (normal, split, flip, transform, modal_dfc, meld, saga, etc.)." },
"highres_image": { "type": "boolean" },
"image_status": { "type": "string", "enum": ["missing", "placeholder", "lowres", "highres_scan"] },
"image_uris": { "$ref": "scryfall-image-uris-schema.json" },
"mana_cost": { "type": "string" },
"cmc": { "type": "number" },
"type_line": { "type": "string" },
"oracle_text": { "type": "string" },
"colors": { "type": "array", "items": { "type": "string", "enum": ["W", "U", "B", "R", "G"] } },
"color_identity": { "type": "array", "items": { "type": "string", "enum": ["W", "U", "B", "R", "G"] } },
"keywords": { "type": "array", "items": { "type": "string" } },
"legalities": { "$ref": "scryfall-legalities-schema.json" },
"games": { "type": "array", "items": { "type": "string", "enum": ["paper", "mtgo", "arena"] } },
"reserved": { "type": "boolean" },
"foil": { "type": "boolean" },
"nonfoil": { "type": "boolean" },
"finishes": { "type": "array", "items": { "type": "string", "enum": ["foil", "nonfoil", "etched"] } },
"oversized": { "type": "boolean" },
"promo": { "type": "boolean" },
"reprint": { "type": "boolean" },
"variation": { "type": "boolean" },
"set_id": { "type": "string", "format": "uuid" },
"set": { "type": "string" },
"set_name": { "type": "string" },
"set_type": { "type": "string" },
"collector_number": { "type": "string" },
"digital": { "type": "boolean" },
"rarity": { "type": "string", "enum": ["common", "uncommon", "rare", "special", "mythic", "bonus"] },
"flavor_text": { "type": "string" },
"artist": { "type": "string" },
"artist_ids": { "type": "array", "items": { "type": "string", "format": "uuid" } },
"illustration_id": { "type": "string", "format": "uuid" },
"border_color": { "type": "string" },
"frame": { "type": "string" },
"frame_effects": { "type": "array", "items": { "type": "string" } },
"security_stamp": { "type": "string" },
"full_art": { "type": "boolean" },
"textless": { "type": "boolean" },
"booster": { "type": "boolean" },
"story_spotlight": { "type": "boolean" },
"edhrec_rank": { "type": "integer" },
"penny_rank": { "type": "integer" },
"prices": { "$ref": "scryfall-prices-schema.json" },
"related_uris": { "type": "object", "additionalProperties": { "type": "string", "format": "uri" } },
"purchase_uris": { "type": "object", "additionalProperties": { "type": "string", "format": "uri" } },
"all_parts": { "type": "array", "items": { "$ref": "scryfall-related-card-schema.json" } },
"card_faces": { "type": "array", "items": { "$ref": "scryfall-card-face-schema.json" } },
"power": { "type": "string" },
"toughness": { "type": "string" },
"loyalty": { "type": "string" },
"defense": { "type": "string" },
"produced_mana": { "type": "array", "items": { "type": "string" } },
"watermark": { "type": "string" }
}
}