# Set
The Set Data 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. This 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- Tags: 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- Tags: Optional
# cards
The list of cards in the set. See the Card (Set) Data Model.
- Type:
array[object]- Introduced:
v4.0.0
# cardsphereSetId
The Cardsphere (opens new window) set identifier.
- Type:
integer- Introduced:
v5.2.1- Tags: OptionalNewPreview v5.2.1
# 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- Tags: Optional
# isForeignOnly
If the set is available only outside the United States of America.
- Type:
boolean- Introduced:
v4.4.1- Tags: 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- Tags: Optional
# isOnlineOnly
If the set is only available in online game variations.
- Type:
boolean- Introduced:
v4.0.0
# isPaperOnly
If the set is available only in paper.
- Type:
boolean- Introduced:
v4.6.2- Tags: Optional
# isPartialPreview
If the set is still in preview (spoiled). Preview sets do not have complete data.
- Type:
boolean- Introduced:
v4.4.2- Tags: Optional
# keyruneCode
The matching Keyrune (opens new window) code for set image icons.
- Type:
string- Introduced:
v4.3.2
# mcmId
The Magic Card Market (opens new window) set identifier.
- Type:
integer- Introduced:
v4.4.0- Tags: 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- Tags: Optional
# mcmName
The Magic Card Market (opens new window) set name.
- Type:
string- Introduced:
v4.4.0- Tags: 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- Tags: 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- Tags: 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.2.0- Tags: OptionalNew
# tcgplayerGroupId
The group identifier of the set on TCGplayer (opens new window).
- Type:
integer- Introduced:
v4.2.1- Tags: 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 promotional and related supplemental products but excluding Alchemy (opens new window) modifications - however those cards are included in the set itself.
- Type:
integer- Introduced:
v4.1.0
# translations
The translated set name by language. See the Translations Data Model.
- Type:
object{} || object{props}- Introduced:
v4.3.2
# type
The expansion type of the set.
- Type:
string- Introduced:
v4.0.0