mightstone.services.scryfall.models.Set
- pydantic model mightstone.services.scryfall.models.Set
- A Set object represents a group of related Magic cards. All Card objects on Scryfall
belong to exactly one set.
- Due to Magic’s long and complicated history, Scryfall includes many un-official sets
- as a way to group promotional or outlier cards together. Such sets will likely have
a code that begins with p or t, such as pcel or tori.
Official sets always have a three-letter set code, such as zen.
Show JSON schema
{ "title": "Set", "description": "A Set object represents a group of related Magic cards. All Card objects on Scryfall\n belong to exactly one set.\n\nDue to Magic\u2019s long and complicated history, Scryfall includes many un-official sets\n as a way to group promotional or outlier cards together. Such sets will likely have\n a code that begins with p or t, such as pcel or tori.\n\nOfficial sets always have a three-letter set code, such as zen.", "type": "object", "properties": { "object": { "const": "set", "enum": [ "set" ], "title": "Object", "type": "string" }, "id": { "format": "uuid", "title": "Id", "type": "string" }, "code": { "title": "Code", "type": "string" }, "mtgo_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Mtgo Code" }, "tcgplayer_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Tcgplayer Id" }, "name": { "title": "Name", "type": "string" }, "set_type": { "$ref": "#/$defs/SetType" }, "released_at": { "anyOf": [ { "format": "date", "type": "string" }, { "type": "null" } ], "default": null, "title": "Released At" }, "block_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Block Code" }, "block": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Block" }, "parent_set_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Parent Set Code" }, "card_count": { "title": "Card Count", "type": "integer" }, "printed_size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Printed Size" }, "digital": { "title": "Digital", "type": "boolean" }, "foil_only": { "title": "Foil Only", "type": "boolean" }, "nonfoil_only": { "title": "Nonfoil Only", "type": "boolean" }, "scryfall_uri": { "format": "uri", "minLength": 1, "title": "Scryfall Uri", "type": "string" }, "uri": { "format": "uri", "minLength": 1, "title": "Uri", "type": "string" }, "icon_svg_uri": { "format": "uri", "minLength": 1, "title": "Icon Svg Uri", "type": "string" }, "search_uri": { "format": "uri", "minLength": 1, "title": "Search Uri", "type": "string" } }, "$defs": { "SetType": { "enum": [ "core", "expansion", "masters", "alchemy", "masterpiece", "arsenal", "from_the_vault", "spellbook", "premium_deck", "duel_deck", "draft_innovation", "treasure_chest", "commander", "planechase", "archenemy", "vanguard", "funny", "starter", "box", "promo", "token", "memorabilia", "minigame" ], "title": "SetType", "type": "string" } }, "required": [ "object", "code", "name", "set_type", "card_count", "digital", "foil_only", "nonfoil_only", "scryfall_uri", "uri", "icon_svg_uri", "search_uri" ] }
- Fields:
code (beanie.odm.fields.Indexed.
- field block: str | None = None
The block or group name code for this set, if any.
- field block_code: str | None = None
The block code for this set, if any.
- field card_count: int [Required]
The number of cards in this set.
- field code: NewType [Required]
The unique three to five-letter code for this set.
- field digital: bool [Required]
True if this set was only released in a video game.
- field foil_only: bool [Required]
True if this set contains only foil cards.
- field icon_svg_uri: Url [Required]
A URI to an SVG file for this set’s icon on Scryfall’s CDN. Hotlinking this image isn’t recommended, because it may change slightly over time. You should download it and use it locally for your particular user interface needs.
- field id: UUID [Optional]
A unique ID for this set on Scryfall that will not change.
- field mtgo_code: str | None = None
The unique code for this set on MTGO, which may differ from the regular code.
- field name: str [Required]
The English name of the set.
- field nonfoil_only: bool [Required]
True if this set contains only nonfoil cards.
- field object: Literal['set'] [Required]
- field parent_set_code: str | None = None
The set code for the parent set, if any. promo and token sets often have a parent set.
- field printed_size: int | None = None
The denominator for the set’s printed collector numbers.
- field released_at: date | None = None
The date the set was released or the first card was printed in the set (in GMT-8 Pacific time).
- field scryfall_uri: Url [Required]
A link to this set’s permapage on Scryfall’s website.
- field search_uri: Url [Required]
A Scryfall API URI that you can request to begin paginating over the cards in this set.
- field set_type: SetType [Required]
A computer-readable classification for this set. See below.
- field tcgplayer_id: int | None = None
This set’s ID on TCGplayer’s API, also known as the groupId.
- field uri: Url [Required]
A link to this set object on Scryfall’s API.