Enums

The API exposes a number of fields whose values are drawn from a fixed, closed set. This page lists every enum and what each value means. The set of enums is locked — adding a new value to any of them counts as a non-breaking change; removing or renaming a value is a breaking change and only happens with a /v2/ version bump.

Card identity

`class`

A Card’s primary type. Determines where it can be played and what rules apply.

Value	Meaning
`spirit`	A Spirit card. Resource cards used to power costs.
`elestral`	A creature card. Has attack, defense, elements, and subclasses.
`rune_divine`	A divine Rune. Persistent effect, often centerpiece of a deck.
`rune_artifact`	An artifact Rune. Equipment-style attachments.
`rune_stadium`	A stadium Rune. Modifies the playing field for both players.
`rune_invoke`	An invoke Rune. One-shot spell-like effect.
`rune_counter`	A counter Rune. Reactive trigger.

`subclasses`

A Card’s secondary creature typing — used by tutors, anti-tribal effects, and synergies. A Card can have zero or more.

Value	Meaning
`aquatic`	Water-dwelling creatures.
`archaic`	Ancient or extinct lineage.
`avian`	Flying creatures.
`behemoth`	Massive land creatures.
`brute`	Strength-focused creatures.
`dragon`	Dragons.
`dryad`	Plant-spirit hybrids.
`eldritch`	Otherworldly entities.
`ethereal`	Spirit-realm creatures.
`golem`	Constructs.
`insectoid`	Insects and arachnids.
`oceanic`	Deep-sea creatures.
`spectral`	Ghosts and shades.
`ursa`	Bears and bear-likes.

`elements`

The elemental affiliation of a Card or Creature. Drives spirit-cost matching, type advantages, and a host of effect text. A Card can have one or more.

Value	Meaning
`earth`	Earth.
`fire`	Fire.
`water`	Water.
`thunder`	Thunder.
`wind`	Wind.
`frost`	Frost.
`solar`	Solar.
`lunar`	Lunar.
`omni`	Omni — matches any spirit cost.

`cost`

Each entry in a Card’s cost array is an ElementToken from the table above, repeated as many times as that element is required. A cost of ["fire", "fire", "omni"] means two fire spirits and one of any element. total_cost is the precomputed sum, included for sort/filter convenience.

Effects

`effect_type`

Top-level classification of an effect’s timing. Every Card effect carries one.

Value	Meaning
`active`	Activated by paying a cost during your turn.
`conditional`	Triggered when a condition is met.
`instant`	Activated from the hand at almost any time.
`passive`	Constantly in effect while the card is in play.

`effect_categories`

A categorical taxonomy of what the effect does. A single effect can have multiple categories. Useful for filtering (“all cards that mill”, “all cards with negate effects”).

Value	Meaning
`search`	Search the deck for a card.
`special_ascend`	Ascend an Elestral outside the once-per-turn Normal Action.
`special_cast`	Cast a card outside the once-per-turn Normal Action (e.g., from an effect).
`normal_cast`	Cast a card via the once-per-turn Normal Action.
`nexus`	Moves Spirits around the field.
`daze`	Inflicts Daze — a Dazed Elestral cannot attack.
`enrage`	Inflicts Enrage — an Enraged Elestral must attack.
`suppress`	Inflicts Suppress — a Suppressed Elestral cannot activate its effect.
`foretell`	Look at the top X cards of your deck, rearrange them, and place them back on top.
`card_removal`	Removes a card from any zone.
`elestral_removal`	Removes an Elestral specifically.
`rune_removal`	Removes a Rune specifically.
`force_disenchant`	Forces disenchantment — removes a Spirit enchanting an Elestral.
`burn`	Direct damage outside combat.
`heal`	Restores HP or removes damage.
`draw`	Draws cards from the deck.
`enchant`	Enchants a card.
`stat_modification`	Changes attack/defense values.
`direct_attack`	Attacks bypassing creatures.
`piercing_damage`	Damages even through defenders.
`hand_ripper`	Forces opponent to discard from hand.
`mill`	Sends cards from a deck to the underworld.
`unaffected`	Cannot be targeted.
`protection`	Prevents specific outcomes.
`steal`	Takes control of an opponent’s card.
`change_properties`	Modifies card properties.
`negate`	Cancels another effect.
`recycle`	Returns cards to the deck.
`block`	Blocks an action.
`position`	Manipulates card position or stance.
`prevention`	Prevents specific events.
`playing_condition`	Modifies playing conditions.
`upkeep`	Triggers during upkeep phase.
`replacement_effect`	Replaces one event with another.
`sever`	Severs a connection or attachment.
`win_condition`	Triggers a win condition.

`effect_subtype` (forward-looking)

A finer-grained classifier than effect_categories. Currently shipped in the OpenAPI spec but null on existing rows; populated as the underlying database column rolls out.

Value	Meaning
`attack`	Triggers on or modifies attack.
`enters_battle`	Triggers when a creature enters battle.
`linked_effect`	Effect chained to another.
`discarded`	Triggers when discarded.
`receive`	Triggers when receiving an effect.
`activate`	Activation effect.
`specific_cast`	Triggers on a specific cast condition.
`self-cast`	Triggers when the card itself is cast.
`deals_damage`	Triggers on dealing damage.
`battle_ko`	Triggers on a battle knockout.
`destroyed`	Triggers when destroyed.
`sent_to_underworld`	Triggers when sent to the Underworld.
`timing`	Modifies effect timing.

Printings

`rarity`

Value	Meaning
`common`	Most common rarity. Black-text rarity stamp.
`uncommon`	Mid-tier rarity.
`rare`	Premium rarity.
`stellar_rare`	Top-tier collector rarity. Hit-rate equivalent of a chase.

`condition`

A printing variant’s foil treatment. A printing has at least one variant; many have two or three.

Value	Meaning
`normal`	Non-foil, standard finish.
`reverse_holo`	Border foiled, art is not.
`holo`	Art is foiled.
`metal`	Metal-finish premium variant.

`canvas`

The art layout of a printing.

Value	Meaning
`regular_art`	Standard art window.
`full_art`	Art extends to the full card.
`borderless_art`	Art extends to the edges; no border treatment.

`frame_material`

The frame texture rendered on the printing.

Value	Meaning
`stone`	Stone-textured frame.
`tablet`	Stone tablet variant.
`marble`	White marble.
`black_marble`	Black marble.
`ethereal`	Translucent ethereal frame.
`crystal`	Crystalline frame.

`holo_pattern`

The foil pattern overlay on a printing’s art. null on non-foil printings.

Value	Meaning
`normal`	Standard holographic pattern.
`fractal`	Fractal-shaped holo.
`stellar`	Star-burst pattern, used on Stellar Rare printings.
`divine`	Divine pattern.
`artist`	Artist-specific signature pattern.

`title_frame`

The title-bar treatment on a printing.

Value	Meaning
`standard`	Standard title bar.
`standard_wide`	Wide variant of the standard frame.
`divine`	Divine title bar — used on `rune_divine` printings.
`divine_wide`	Wide variant of the divine frame.

`image_type`

The kind of image at a particular PrintingImage URL. Multiple images per printing surface different crops.

Value	Meaning
`card_front`	Full card front.
`art_main`	Main art crop, no card chrome.
`art_secondary`	Secondary art crop (when the card has multiple).
`art_cutout`	Subject cut out from background.

Sets

`set_type`

Value	Meaning
`main`	A main-line booster expansion.
`promo`	Promotional cards (events, products, partnerships).
`starter_deck`	Starter or theme deck.
`specialty`	Specialty product (collector boxes, anniversary releases).

`subset`

Value	Meaning
`main`	A printing belongs to the main set body.
`starter_deck`	A printing comes from a starter deck attached to the set.

Banlists and rulings

`legality`

A Card’s legal status in a given format.

Value	Meaning
`legal`	No restriction.
`semi_limited`	Up to 2 copies allowed in a deck.
`limited`	Up to 1 copy allowed in a deck.
`banned`	Not allowed at all.
`illegal`	Not legal in the format because it doesn’t qualify (e.g., released after the format’s cutoff). Distinct from `banned`.

`prize_rank`

Tournament-prize-card placement.

Value	Meaning
`1st`	First place prize printing.
`2nd`	Second place.
`3rd`	Third place.
`top_16`	Top-16 placement printing.

Getting started

Authentication

Rate limits & quotas

Pagination & errors

Best practices

Game references

Card identity

`class`

`subclasses`

`elements`

`cost`

Effects

`effect_type`

`effect_categories`

`effect_subtype` (forward-looking)

Printings

`rarity`

`condition`

`canvas`

`frame_material`

`holo_pattern`

`title_frame`

`image_type`

Sets

`set_type`

`subset`

Banlists and rulings

`legality`

`prize_rank`

​Card identity

​class

​subclasses

​elements

​cost

​Effects

​effect_type

​effect_categories

​effect_subtype (forward-looking)

​Printings

​rarity

​condition

​canvas

​frame_material

​holo_pattern

​title_frame

​image_type

​Sets

​set_type

​subset

​Banlists and rulings

​legality

​prize_rank

Card identity

`class`

`subclasses`

`elements`

`cost`

Effects

`effect_type`

`effect_categories`

`effect_subtype` (forward-looking)

Printings

`rarity`

`condition`

`canvas`

`frame_material`

`holo_pattern`

`title_frame`

`image_type`

Sets

`set_type`

`subset`

Banlists and rulings

`legality`

`prize_rank`