Individual Set

The individual set structure describes the properties and values of a single set.

Parent property type: object(string: any)

Data Structure

Property Attributes

The property attributes you see below earmark possible conditions for a field in this data structure.

    Property Information

    Type

    integer

    Introduced

    v4.1.0

    Example

    259

    Description

    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.

    Name

    Type

    string

    Introduced

    v4.0.0

    Example

    "Guilds of Ravnica"

    Description

    Block name the set was in.

    Type

    array(array, string)

    Introduced

    v4.1.0

    Example

    [[mythic, rare], uncommon]

    Description

    The card rarity contents of a typical booster pack. This field is backwards compatible with MTGJSON v3.

    Name

    Type

    array(object)

    Introduced

    v4.0.0

    Example

    Description

    List of cards in this set.

    Name

    Type

    string

    Introduced

    v4.0.0

    Example

    "RNA"

    Description

    Set code for the set.

    Name

    Type

    string

    Introduced

    v4.2.1

    Example

    "XYZ"

    Description

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

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.1

    Example

    true

    Description

    Is this set available only outside the United States?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.0.0

    Example

    true

    Description

    Is the set available only in foil?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.0.0

    Example

    true

    Description

    Is the set available online only?

    Attributes

    optional

    Type

    boolean

    Introduced

    v4.4.2

    Example

    true

    Description

    Is the set still in preview? Preview sets do not have complete data.

    Attributes

    optional

    Type

    string

    Introduced

    v4.3.2

    Example

    "KTK"

    Description

    The matching keyrune code for Keyrune image icons.

    Type

    string

    Introduced

    v4.4.0

    Example

    "Ravnica Allegiance"

    Description

    The Magic Card Market set name.

    Name

    Type

    integer

    Introduced

    v4.4.0

    Example

    2411

    Description

    The Magic Card Market set ID.

    Name

    Type

    object(string: string)

    Introduced

    v4.0.0

    Example

    Description

    See the version structure.

    Type

    string

    Introduced

    v4.0.0

    Example

    "RNA"

    Description

    Set code for the set as it appears on Magic: The Gathering Online.

    Name

    Type

    string

    Introduced

    v4.0.0

    Example

    "Ravnica Allegiance"

    Description

    Name of the set.

    Type

    string

    Introduced

    v4.3.0

    Example

    "RNA"

    Description

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

    Type

    string

    Introduced

    v4.0.0

    Example

    "2019-01-25"

    Description

    Release date in ISO-8601 format for the set.

    Type

    integer

    Introduced

    v4.2.1

    Example

    2366

    Description

    Group ID of the set on TCGPlayer.

    Name

    Type

    array(object)

    Introduced

    v4.0.0

    Example

    Description

    Tokens available to the set. See the token structure.

    Type

    integer

    Introduced

    v4.1.0

    Example

    273

    Description

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

    Type

    object(string: string)

    Introduced

    v4.3.2

    Description

    Translated set name by language. See the translations structure.

    Name

    Type

    string

    Introduced

    v4.0.0

    Example

    "expansion"

    Description

    As of 03-28-2019, the possible values are archenemy, box, core, commander, draft_innovation, duel_deck, expansion, from_the_vault, funny, masters, masterpiece, memorabilia, spellbook, planechase, premium_deck, promo, starter, token, treasure_chest, or vanguard

    Attributes

    stale
    Last Updated: 2019-08-12