Card reference

A card reference contains the minimal amount of information in order to uniquely identify a card. It cannot exist as a resource on its own.

Property	Type	Is required	Description
cardId	string|null	No	See CMS.
expansion	Expansion	Yes
cardNumber	string|null	Yes
cardNumberSortingOrder	int32|null	No
additionalCardData	AdditionalCardData|null	No

AdditionalCardData

The additional card data provides additional data for the card matching process when no card number is present.

Property	Type	Is required	Description
name	string|null	No
rarity	string|null	No
isRaritySet	boolean	No	Defaults to false. Because not all cards have a rarity, this property is required to indicate if a null value means the card has no rarity (true) or the property is not set (false).
illustrators	string[]|null	No

Example

{
  "expansion": {
    "name": "VMAX Climax",
    "series": "Sword & Shield Era",
    "tcgRegion": "Japan",
    "codes": [
      "S8b"
    ],
    "releaseDate": "2021-12-03T00:00:00Z",
    "cardNumberRightPart": "184"
  },
  "cardNumber": "002/184",
  "cardNumberSortingOrder": 2,
  "additionalCardData": {
    "name": null,
    "rarity": null,
    "isRaritySet": true,
    "illustrators": [
      "nagimiso"
    ]
  }
}