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., star-birth/001-100.card-mapping.json.

Example

{
  "from": {
    "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,
    "additionalCardData": {
      "name": null,
      "rarity": "Common (C)",
      "isRaritySet": true,
      "illustrators": null
    }
  },
  "to": {
    "expansion": {
      "name": "Brilliant Stars",
      "series": "Sword & Shield Series",
      "tcgRegion": "International",
      "codes": [
          "BRS"
      ],
      "releaseDate": "2022-02-25T00:00:00Z",
      "cardNumberRightPart": "172"
    },
    "cardNumber": "001/172",
    "cardNumberSortingOrder": null,
    "additionalCardData": null
  }
}