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

View JSON Schema on GitHub

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" }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/scryfall-card"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.