Scryfall · Controlled Vocabulary
Scryfall Domain Vocabulary
Magic - The Gathering domain vocabulary for the Scryfall API surface; sourced from OpenAPI tags, card fields, set types, formats, and symbology.
47 Terms
Updated
Scryfall Vocabulary is a controlled vocabulary published by Scryfall on the APIs.io network, defining 47 terms.
Defined terms include Cards, Sets, Rulings, Symbology, and Catalogs.
A controlled vocabulary pins the words an API’s schemas, parameters and documentation use to one agreed definition each — the shared language a human or an agent needs to read the API the same way its authors do.
Terms
Cards
Magic - The Gathering card printings keyed by Scryfall ID; the central resource.
Sets
Magic sets, products, and supplemental releases identified by three-to-five-letter codes.
Rulings
Oracle rulings, Wizards of the Coast release notes, and Scryfall notes for a card.
Symbology
All card mana and text symbols (e.g. {R}, {W/U}, {T}) and their semantics.
Catalogs
Convenience lists of Magic data points - card names, creature types, supertypes, etc.
Bulk Data
Daily downloadable exports of the entire Scryfall card and rulings dataset.
Migrations
Records of card-object merges and deletions across the Scryfall database.
Oracle Identity
The oracle_id grouping all printings of the same card across reprints.
Oracle Text
The current rules text for a card per the latest Oracle update.
Mana Cost
The symbolic cost a player pays to cast a card (e.g. {2}{R}{R}).
Converted Mana Cost
Also called mana value; the total mana cost expressed as a number.
Color Identity
The set of colors that appear in a card's mana cost, rules text, color indicator, or characteristic-defining ability.
Layout
How a card is physically printed - normal, split, flip, transform, modal_dfc, meld, leveler, class, saga, adventure, mutate, prototype, case, etc.
Format Legalities
A card's status (legal, not_legal, restricted, banned) in each play format.
Standard
Rotating constructed format containing the most recent sets.
Modern
Non-rotating constructed format including all sets from Eighth Edition onward.
Legacy
Eternal constructed format encompassing nearly all cards ever printed.
Vintage
Eternal format permitting the most cards; uses a restricted list.
Commander
Multiplayer format built around a singleton 100-card deck with a legendary commander.
Pauper
Constructed format limited to cards printed at common rarity.
Pioneer
Non-rotating constructed format including sets from Return to Ravnica onward.
Brawl
Singleton constructed format using Standard-legal cards.
Alchemy
Arena-only constructed format with digital-only rebalanced cards.
Bulk Data Type
One of oracle_cards, unique_artwork, default_cards, all_cards, or rulings.
Rarity
Card rarity - common, uncommon, rare, mythic, special, or bonus.
Set Type
Classification of a Magic product - core, expansion, masters, commander, alchemy, etc.
Collector Number
The printed number identifying a card within its set.
Multiverse ID
A Wizards of the Coast Gatherer identifier for a card.
MTGO ID
A Magic Online catalog identifier for a card.
Arena ID
A Magic Arena identifier for a card.
TCGplayer ID
TCGplayer's product identifier for a card or set.
Cardmarket ID
Cardmarket's idProduct identifier for a card.
Image URIs
URIs for card image renderings at small, normal, large, png, art_crop, and border_crop sizes.
Prices
Current market prices in USD, EUR, and MTGO Tix for normal, foil, and etched finishes.
Finish
A printing finish - foil, nonfoil, or etched.
Frame Effect
A visual treatment applied to a card frame (showcase, extendedart, inverted, etc.).
Border Color
The color of the card border - black, white, borderless, silver, gold.
Security Stamp
A holofoil security marker introduced on modern rare and mythic printings.
Promo Type
A category of promotional treatment applied to a card printing.
Keyword Ability
A named card ability defined in the comprehensive rules (Flying, Trample, etc.).
Keyword Action
A named action verb in Magic rules text (Scry, Surveil, Mill, etc.).
Ability Word
An italicized term that flavors a triggered or activated ability without rules meaning of its own.
Watermark
A faint illustration overlaid on the text box indicating guild, faction, or set affiliation.
Search Query Syntax
Scryfall's fulltext query language used by the /cards/search endpoint.
User-Agent Header
Required descriptive header identifying the API client on every request.
Accept Header
Required header declaring the desired response media type.
Rate Limit
Maximum sustained request rate; Scryfall asks for under 10 requests per second.