MTG Copilot Docs
Data model

Sets

Magic set metadata: codes, names, release dates, and printing counts.

7 columns. Every value below is generated from the provenance registry.

FieldTypeSourceUpdatedWritten by
codestringmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
Lowercase set code (matches card_printings.set_code); primary key.
namestringmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
Set display name (from printings for placeholder rows).
release_datestring | nullmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
Set release date; NULL on placeholder rows.
set_typestring | nullmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
MTGJSON set type (expansion, core, commander, masters, promo…).
parent_set_codestring | nullmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
Parent set code for child sets (promos, tokens).
card_countnumber | nullmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
Total cards in the set per MTGJSON.
mtgjson_knownbooleanmtgjsonon set releasescripts/ingest-mtgjson.ts (sets)
False for placeholder rows covering printing set-codes MTGJSON lacks (Scryfall-only promo/token codes).

TypeScript model

interface sets {
  code:            string
  name:            string
  release_date:    string | null
  set_type:        string | null
  parent_set_code: string | null
  card_count:      number | null
  mtgjson_known:   boolean
}

On this page