# Set

The Set file model describes the properties and values of an individual set.

Parent file: AllPrintings, Legacy, Modern, Pioneer, Standard, Vintage
Parent property: data

# Model Index

# Model Properties

# baseSetSize

Number of cards in the set. Will default to totalSetSize if not available. Note that Wizards sometimes prints extra cards beyond the set size into promos or supplemental products.

  • Type: integer
  • Introduced: v4.1.0

# block

Block name the set was in.

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# booster

A breakdown of possibilities and weights of cards in a booster pack. See the Booster data model.

  • Type: object(props)
  • Introduced: v5.0.0
  • Attributes: optional

# cards

List of cards in this set. See the Card (Set) data model.

  • Type: array(object)
  • Introduced: v4.0.0

# code

Set code for the set.

  • Type: string
  • Introduced: v4.0.0

# codeV3

Alternate set code Wizards uses for a select few duel deck sets.

  • Type: string
  • Introduced: v4.2.1
  • Attributes: optional

# isForeignOnly

If this set is available only outside the United States.

  • Type: boolean
  • Introduced: v4.4.1
  • Attributes: optional

# isFoilOnly

If this set is only available in foil.

  • Type: boolean
  • Introduced: v4.0.0

# isNonFoilOnly

If this set is only available in non-foil.

  • Type: boolean
  • Introduced: v5.0.0
  • Attributes: optional

# isOnlineOnly

If this set is available only online.

  • Type: boolean
  • Introduced: v4.0.0

# isPaperOnly

If this set is available only in paper.

  • Type: boolean
  • Introduced: v4.6.2
  • Attributes: optional

# isPartialPreview

If this set is still in preview (spoiled). Preview sets do not have complete data.

  • Type: boolean
  • Introduced: v4.4.2
  • Attributes: optional

# keyruneCode

The matching Keyrune code for Keyrune (opens new window) image icons.

  • Type: string
  • Introduced: v4.3.2

# mcmId

The Magic Card Market (opens new window) set identifier.

  • Type: integer
  • Introduced: v4.4.0
  • Attributes: optional

# mcmIdExtras

The split Magic Card Market (opens new window) set identifier if a set is printed in two sets. This identifier represents the second set's identifier.

  • Type: integer
  • Introduced: v5.1.0
  • Attributes: optional

# mcmName

The Magic Card Market (opens new window) set name.

  • Type: string
  • Introduced: v4.4.0
  • Attributes: optional

# mtgoCode

Set code for the set as it appears on Magic: The Gathering Online (opens new window).

  • Type: string
  • Introduced: v4.0.0
  • Attributes: optional

# name

Name of the set.

  • Type: string
  • Introduced: v4.0.0

# parentCode

The parent set code for set variations like promotions, guild kits, etc.

  • Type: string
  • Introduced: v4.3.0
  • Attributes: optional

# releaseDate

Release date in ISO 8601 (opens new window) format for the set.

  • Type: string
  • Introduced: v4.0.0

# tcgplayerGroupId

Group identifier of the set on TCGplayer (opens new window).

  • Type: integer
  • Introduced: v4.2.1
  • Attributes: optional

# tokens

Tokens available to the set. See the Card (Token) data model.

  • Type: array(object)
  • Introduced: v4.0.0

# totalSetSize

Total number of cards in the set, including promos and related supplemental products.

  • Type: integer
  • Introduced: v4.1.0

# translations

Translated set name by language. See the Translations data model.

  • Type: object(props)
  • Introduced: v4.3.2

# type

Expansion type of the set.

  • Type: string
  • Introduced: v4.0.0