Individual cards

Get card by slug.

get

This returns a card matching the provided slug.

Path parameters

slugstringRequired

The card's URL-friendly slug.

Example: crescent-glaive

Responses

200

The matching card.

application/json

The matching card.

classesstring[]Required

The card's classes. The possible values are revealed by the option/search endpoint.

Example: ["WARRIOR"]

cost_memorynumber · nullableRequiredDeprecated

The card's memory cost (cost_reserve will be null if this is numeric). Be aware that cards can have both memory and reserve cost set to null (example: Shifting Currents).

Example: 1

cost_reservenumber · min: -1 · nullableRequiredDeprecated

The card's reserve cost (cost_memory will be null if this is numeric). -1 represents a card with "X" cost (example: Lost in Thought). Be aware that cards can have both memory and reserve cost set to null (example: Shifting Currents).

created_atstring · date-timeRequired

When the dataset was created.

Example: 2024-10-11T12:00:00+00:00

durabilitynumber · nullableRequired

The card's durability stat.

Example: 3

elementstringRequiredDeprecated

The card's element. The possible values are revealed by the option/search endpoint.

Example: WATER

elementsstring[]Required

The card's element(s). The possible values are revealed by the option/search endpoint.

Example: ["WATER"]

effectstring · nullableRequired

The card's effect as a template.

Example:

[Class Bonus] [Level 2+] CARDNAME gets +1 [POWER]. *(Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)*

effect_htmlstring · nullableRequiredDeprecated

The card's effect as HTML. This is null if the card's effect value is null.

Example:

<span class="effect__bubble">Class Bonus</span> <span class="effect__bubble">Level 2+</span> Crescent Glaive gets +1<span class="effect__icon effect__icon--sword"></span>. <span class="effect__reminder">(Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)</span>

effect_rawstring · nullableRequired

The card's effect as plain text. This is null if the card's effect value is null.

Example:

[Class Bonus] [Level 2+] Crescent Glaive gets +1 POWER. (Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)

flavorstring · nullableRequired

The card's flavor text.

Example: Convalescing waves cascade through the soul, revitalizing the body and mind from the depths.

last_updatestring · date-timeRequired

When the dataset was last updated.

Example: 2024-10-11T12:00:00+00:00

legalityany of · nullableRequired

Legality limits the card is subject to. This is only populated if the card is limited in certain formats. The possible game format values are revealed by the option/search endpoint.

levelnumber · nullableRequired

The card's level stat.

lifenumber · nullableRequired

The card's life stat.

namestringRequired

The card's name.

Example: Crescent Glaive

powernumber · nullableRequired

The card's power stat.

Example: 1

speedboolean · nullableRequired

The card's speed stat. true represents Fast whilst false represents Slow.

slugstringRequired

The card's URL-friendly slug.

Example: crescent-glaive

subtypesstring[]Required

The card's subtypes. The possible values are revealed by the option/search endpoint.

Example: ["WARRIOR","POLEARM"]

typesstring[]Required

The card's types. The possible values are revealed by the option/search endpoint.

Example: ["REGALIA","WEAPON"]

uuidstringRequired

A 10-character alphanumeric UUID.

Example: abcde12345

404Error

application/json

get

/cards/{slug}

GET /cards/{slug} HTTP/1.1
Host: api.gatcg.com
Accept: */*

{
  "classes": [
    "WARRIOR"
  ],
  "cost": {
    "type": "memory",
    "value": "1"
  },
  "created_at": "2024-10-11T12:00:00+00:00",
  "durability": 3,
  "editions": [
    {
      "card_id": "abcde12345",
      "circulationTemplates": [
        {
          "kind": "FOIL",
          "population": 100,
          "population_operator": "=",
          "printing": false,
          "created_at": "2024-10-11T12:00:00+00:00",
          "edition_id": "abcde12345",
          "foil": false,
          "uuid": "abcde12345",
          "variants": [],
          "name": "AMB NF C 2"
        }
      ],
      "circulations": [],
      "collaborators": [],
      "collector_number": "010",
      "configuration": "default",
      "created_at": "2024-10-11T12:00:00+00:00",
      "effect": null,
      "effect_html": null,
      "effect_raw": null,
      "flavor": "The centerpiece of the Imperial Armory.",
      "illustrator": "Dragonart",
      "image": "text",
      "last_update": "2024-10-11T12:00:00+00:00",
      "orientation": null,
      "other_orientations": [],
      "rarity": 1,
      "slug": "crescent-glaive-amb",
      "set": {
        "created_at": "2024-10-11T12:00:00+00:00",
        "id": "abcde12345",
        "language": "EN",
        "last_update": "2024-10-11T12:00:00+00:00",
        "name": "Mortal Ambition",
        "prefix": "AMB",
        "release_date": "2024-10-11T00:00:00"
      },
      "thema_charm_foil": null,
      "thema_ferocity_foil": null,
      "thema_foil": null,
      "thema_grace_foil": null,
      "thema_mystique_foil": null,
      "thema_valor_foil": null,
      "thema_charm_nonfoil": null,
      "thema_ferocity_nonfoil": null,
      "thema_grace_nonfoil": null,
      "thema_mystique_nonfoil": null,
      "thema_nonfoil": null,
      "thema_valor_nonfoil": null,
      "thema_foil_dynamic": false,
      "thema_nonfoil_dynamic": false,
      "uuid": "abcde12345"
    }
  ],
  "elements": [
    "WATER"
  ],
  "effect": "[Class Bonus] [Level 2+] CARDNAME gets +1 [POWER]. *(Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)*",
  "effect_raw": "[Class Bonus] [Level 2+] Crescent Glaive gets +1 POWER. (Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)",
  "flavor": "Convalescing waves cascade through the soul, revitalizing the body and mind from the depths.",
  "last_update": "2024-10-11T12:00:00+00:00",
  "legality": null,
  "level": null,
  "life": null,
  "name": "Crescent Glaive",
  "power": 1,
  "referenced_by": [],
  "references": [],
  "result_editions": [
    {
      "card_id": "abcde12345",
      "circulationTemplates": [
        {
          "kind": "FOIL",
          "population": 100,
          "population_operator": "=",
          "printing": false,
          "created_at": "2024-10-11T12:00:00+00:00",
          "edition_id": "abcde12345",
          "foil": false,
          "uuid": "abcde12345",
          "variants": [],
          "name": "AMB NF C 2"
        }
      ],
      "circulations": [],
      "collaborators": [],
      "collector_number": "010",
      "configuration": "default",
      "created_at": "2024-10-11T12:00:00+00:00",
      "effect": null,
      "effect_html": null,
      "effect_raw": null,
      "flavor": "The centerpiece of the Imperial Armory.",
      "illustrator": "Dragonart",
      "image": "text",
      "last_update": "2024-10-11T12:00:00+00:00",
      "orientation": null,
      "other_orientations": [],
      "rarity": 1,
      "slug": "crescent-glaive-amb",
      "set": {
        "created_at": "2024-10-11T12:00:00+00:00",
        "id": "abcde12345",
        "language": "EN",
        "last_update": "2024-10-11T12:00:00+00:00",
        "name": "Mortal Ambition",
        "prefix": "AMB",
        "release_date": "2024-10-11T00:00:00"
      },
      "thema_charm_foil": null,
      "thema_ferocity_foil": null,
      "thema_foil": null,
      "thema_grace_foil": null,
      "thema_mystique_foil": null,
      "thema_valor_foil": null,
      "thema_charm_nonfoil": null,
      "thema_ferocity_nonfoil": null,
      "thema_grace_nonfoil": null,
      "thema_mystique_nonfoil": null,
      "thema_nonfoil": null,
      "thema_valor_nonfoil": null,
      "thema_foil_dynamic": false,
      "thema_nonfoil_dynamic": false,
      "uuid": "abcde12345"
    }
  ],
  "rule": [],
  "speed": null,
  "slug": "crescent-glaive",
  "subtypes": [
    "WARRIOR",
    "POLEARM"
  ],
  "types": [
    "REGALIA",
    "WEAPON"
  ],
  "uuid": "abcde12345"
}

Get card by its set and collector number.

get

This returns a card matching the provided set prefix and collector number combination.

Path parameters

collector_numberstringRequired

The edition's collector number in the set it belongs to.

Example: 010

set_prefixstringRequired

The set's prefix as printed in the footer of its cards.

Example: AMB

Responses

200

The matching card.

application/json

The matching card.

classesstring[]Required

The card's classes. The possible values are revealed by the option/search endpoint.

Example: ["WARRIOR"]

cost_memorynumber · nullableRequiredDeprecated

The card's memory cost (cost_reserve will be null if this is numeric). Be aware that cards can have both memory and reserve cost set to null (example: Shifting Currents).

Example: 1

cost_reservenumber · min: -1 · nullableRequiredDeprecated

created_atstring · date-timeRequired

When the dataset was created.

Example: 2024-10-11T12:00:00+00:00

durabilitynumber · nullableRequired

The card's durability stat.

Example: 3

elementstringRequiredDeprecated

The card's element. The possible values are revealed by the option/search endpoint.

Example: WATER

elementsstring[]Required

The card's element(s). The possible values are revealed by the option/search endpoint.

Example: ["WATER"]

effectstring · nullableRequired

The card's effect as a template.

Example:

[Class Bonus] [Level 2+] CARDNAME gets +1 [POWER]. *(Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)*

effect_htmlstring · nullableRequiredDeprecated

The card's effect as HTML. This is null if the card's effect value is null.

Example:

<span class="effect__bubble">Class Bonus</span> <span class="effect__bubble">Level 2+</span> Crescent Glaive gets +1<span class="effect__icon effect__icon--sword"></span>. <span class="effect__reminder">(Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)</span>

effect_rawstring · nullableRequired

The card's effect as plain text. This is null if the card's effect value is null.

Example:

[Class Bonus] [Level 2+] Crescent Glaive gets +1 POWER. (Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)

flavorstring · nullableRequired

The card's flavor text.

Example: Convalescing waves cascade through the soul, revitalizing the body and mind from the depths.

last_updatestring · date-timeRequired

When the dataset was last updated.

Example: 2024-10-11T12:00:00+00:00

legalityany of · nullableRequired

Legality limits the card is subject to. This is only populated if the card is limited in certain formats. The possible game format values are revealed by the option/search endpoint.

levelnumber · nullableRequired

The card's level stat.

lifenumber · nullableRequired

The card's life stat.

namestringRequired

The card's name.

Example: Crescent Glaive

powernumber · nullableRequired

The card's power stat.

Example: 1

speedboolean · nullableRequired

The card's speed stat. true represents Fast whilst false represents Slow.

slugstringRequired

The card's URL-friendly slug.

Example: crescent-glaive

subtypesstring[]Required

The card's subtypes. The possible values are revealed by the option/search endpoint.

Example: ["WARRIOR","POLEARM"]

typesstring[]Required

The card's types. The possible values are revealed by the option/search endpoint.

Example: ["REGALIA","WEAPON"]

uuidstringRequired

A 10-character alphanumeric UUID.

Example: abcde12345

404Error

application/json

get

/cards/{set_prefix}/{collector_number}

GET /cards/{set_prefix}/{collector_number} HTTP/1.1
Host: api.gatcg.com
Accept: */*

{
  "classes": [
    "WARRIOR"
  ],
  "cost": {
    "type": "memory",
    "value": "1"
  },
  "created_at": "2024-10-11T12:00:00+00:00",
  "durability": 3,
  "editions": [
    {
      "card_id": "abcde12345",
      "circulationTemplates": [
        {
          "kind": "FOIL",
          "population": 100,
          "population_operator": "=",
          "printing": false,
          "created_at": "2024-10-11T12:00:00+00:00",
          "edition_id": "abcde12345",
          "foil": false,
          "uuid": "abcde12345",
          "variants": [],
          "name": "AMB NF C 2"
        }
      ],
      "circulations": [],
      "collaborators": [],
      "collector_number": "010",
      "configuration": "default",
      "created_at": "2024-10-11T12:00:00+00:00",
      "effect": null,
      "effect_html": null,
      "effect_raw": null,
      "flavor": "The centerpiece of the Imperial Armory.",
      "illustrator": "Dragonart",
      "image": "text",
      "last_update": "2024-10-11T12:00:00+00:00",
      "orientation": null,
      "other_orientations": [],
      "rarity": 1,
      "slug": "crescent-glaive-amb",
      "set": {
        "created_at": "2024-10-11T12:00:00+00:00",
        "id": "abcde12345",
        "language": "EN",
        "last_update": "2024-10-11T12:00:00+00:00",
        "name": "Mortal Ambition",
        "prefix": "AMB",
        "release_date": "2024-10-11T00:00:00"
      },
      "thema_charm_foil": null,
      "thema_ferocity_foil": null,
      "thema_foil": null,
      "thema_grace_foil": null,
      "thema_mystique_foil": null,
      "thema_valor_foil": null,
      "thema_charm_nonfoil": null,
      "thema_ferocity_nonfoil": null,
      "thema_grace_nonfoil": null,
      "thema_mystique_nonfoil": null,
      "thema_nonfoil": null,
      "thema_valor_nonfoil": null,
      "thema_foil_dynamic": false,
      "thema_nonfoil_dynamic": false,
      "uuid": "abcde12345"
    }
  ],
  "elements": [
    "WATER"
  ],
  "effect": "[Class Bonus] [Level 2+] CARDNAME gets +1 [POWER]. *(Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)*",
  "effect_raw": "[Class Bonus] [Level 2+] Crescent Glaive gets +1 POWER. (Apply this effect only if your champion's class matches this card's class and only if your champion is level 2 or higher.)",
  "flavor": "Convalescing waves cascade through the soul, revitalizing the body and mind from the depths.",
  "last_update": "2024-10-11T12:00:00+00:00",
  "legality": null,
  "level": null,
  "life": null,
  "name": "Crescent Glaive",
  "power": 1,
  "referenced_by": [],
  "references": [],
  "result_editions": [
    {
      "card_id": "abcde12345",
      "circulationTemplates": [
        {
          "kind": "FOIL",
          "population": 100,
          "population_operator": "=",
          "printing": false,
          "created_at": "2024-10-11T12:00:00+00:00",
          "edition_id": "abcde12345",
          "foil": false,
          "uuid": "abcde12345",
          "variants": [],
          "name": "AMB NF C 2"
        }
      ],
      "circulations": [],
      "collaborators": [],
      "collector_number": "010",
      "configuration": "default",
      "created_at": "2024-10-11T12:00:00+00:00",
      "effect": null,
      "effect_html": null,
      "effect_raw": null,
      "flavor": "The centerpiece of the Imperial Armory.",
      "illustrator": "Dragonart",
      "image": "text",
      "last_update": "2024-10-11T12:00:00+00:00",
      "orientation": null,
      "other_orientations": [],
      "rarity": 1,
      "slug": "crescent-glaive-amb",
      "set": {
        "created_at": "2024-10-11T12:00:00+00:00",
        "id": "abcde12345",
        "language": "EN",
        "last_update": "2024-10-11T12:00:00+00:00",
        "name": "Mortal Ambition",
        "prefix": "AMB",
        "release_date": "2024-10-11T00:00:00"
      },
      "thema_charm_foil": null,
      "thema_ferocity_foil": null,
      "thema_foil": null,
      "thema_grace_foil": null,
      "thema_mystique_foil": null,
      "thema_valor_foil": null,
      "thema_charm_nonfoil": null,
      "thema_ferocity_nonfoil": null,
      "thema_grace_nonfoil": null,
      "thema_mystique_nonfoil": null,
      "thema_nonfoil": null,
      "thema_valor_nonfoil": null,
      "thema_foil_dynamic": false,
      "thema_nonfoil_dynamic": false,
      "uuid": "abcde12345"
    }
  ],
  "rule": [],
  "speed": null,
  "slug": "crescent-glaive",
  "subtypes": [
    "WARRIOR",
    "POLEARM"
  ],
  "types": [
    "REGALIA",
    "WEAPON"
  ],
  "uuid": "abcde12345"
}

Get a card edition's image.

get

Path parameters

filenamestringRequired

The filename to download.

Example: lorraine-wandering-warrior-doap.jpg

Query parameters

roundedbooleanOptional

Round the corners of the image. Note that whilst the request remains as .jpg the output file type will be .png instead.

Responses

200

Image file.

application/json

string · binary[]Optional

Image file.

404Error

application/json

get

/cards/images/{filename}

GET /cards/images/{filename} HTTP/1.1
Host: api.gatcg.com
Accept: */*

[
  "binary"
]

PreviousMultiple cards NextFeatured set groups

Last updated 4 months ago