# 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

The number of cards in the set. Will default to totalSetSize if not available. Wizards of the Coast (opens new window) sometimes prints extra cards beyond the set size into promos or supplemental products.

  • Type: integer
  • Introduced: v4.1.0

# block

The 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 abstract model.

  • Type: object{props}
  • Introduced: v5.0.0
  • Attributes: optional

# cards

The list of cards in the set. See the Card (Set) data model.

  • Type: array[object]
  • Introduced: v4.0.0

# code

The set code for the set.

  • Type: string
  • Introduced: v4.0.0

# codeV3

The alternate set code Wizards of the Coast (opens new window) uses for a select few duel deck sets.

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

# isForeignOnly

If the set is available only outside the United States of America.

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

# isFoilOnly

If the set is only available in foil.

  • Type: boolean
  • Introduced: v4.0.0

# isNonFoilOnly

If the set is only available in non-foil.

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

# isOnlineOnly

If the set is only available online.

  • Type: boolean
  • Introduced: v4.0.0

# isPaperOnly

If the set is available only in paper.

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

# isPartialPreview

If the 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

The 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

The 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

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

  • Type: string
  • Introduced: v4.0.0

# sealedProduct

The sealed product information for the set. See the Sealed Product data model.

  • Type: object{props}
  • Introduced: v5.1.0
  • Attributes: optional

# tcgplayerGroupId

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

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

# tokens

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

  • Type: array[object]
  • Introduced: v4.0.0

# totalSetSize

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

  • Type: integer
  • Introduced: v4.1.0

# translations

The translated set name by language. See the Translations data model.

  • Type: object{props}
  • Introduced: v4.3.2

# type

The expansion type of the set.

  • Type: string
  • Introduced: v4.0.0