Skip to content

Card mapping

A card mapping is used to map cards across different TCG regions.

Property Type Is required Description
from CardReference Yes
to CardReference|null Yes

When used as a file, the card-mapping suffix is required, e.g., japan/star-birth/001-100.card-mapping.json.

Example

{
  "from": {
    "cardName": "Exeggcute",
    "expansion": {
      "name": "Star Birth",
      "series": "Sword & Shield Era",
      "tcgRegion": "Japan",
      "codes": [
        "S9"
      ],
      "releaseDate": "2022-01-14T00:00:00Z",
      "cardNumberRightPart": "100"
    },
    "cardNumber": "001/100",
    "cardNumberSortingOrder": 1,
    "cardRarity": "Common (C)",
    "isCardRaritySet": true,
    "cardIllustrators": [
      "0313"
    ]
  },
  "to": {
    "cardName": "Exeggcute",
    "expansion": {
      "name": "Brilliant Stars",
      "series": "Sword & Shield Series",
      "tcgRegion": "International",
      "codes": [
          "BRS"
      ],
      "releaseDate": "2022-02-25T00:00:00Z",
      "cardNumberRightPart": "172"
    },
    "cardNumber": "001/172",
    "cardNumberSortingOrder": 1,
    "cardRarity": "Common",
    "isCardRaritySet": true,
    "cardIllustrators": [
      "0313"
    ]
  }
}