Multiple cards
This returns cards matching the provided query parameters.
Get cards with any class value included in this list.
Use this to adjust how cards are targeted by the class query parameter. OR includes any card which includes one or more of the class values, whilst AND only matches cards that include all of the specified class values.
ORPossible values: Include or exclude editions which have collaborators.
Get a card with an edition's collector_number that exactly matches this string.
Find cards using a specific configuration.
flipPossible values: Get a card with an edition's effect_raw that is similar to this string.
Get a card with an edition's flavor that is similar to this string.
Get a card with an edition's last_update date greater than this value.
2023-03-30Get a card with an edition's slug that exactly matches this string.
Get a card with effect_raw or edition effect_raw that is similar to this string.
Get cards with any elements value included in this list. \"null\" can be used to match cards with no element.
Use this to adjust how cards are targeted by the element query parameter. OR includes any card which includes one or more of the elements values, whilst AND only matches cards that include all of the specified elements values.
ORPossible values: Get a card with a flavor that is similar to this string.
Get a card with an edition's illustrator that exactly matches this string. "null" can be used to match cards with no illustrator.
Get a card with an edition's set's language that exactly matches this string.
Get a card with a last_update date greater than this value.
2023-03-30Used in parallel with legality_limit, specify which game format to target.
Used in parallel with legality_format, specify an exact card limit.
Used in parallel with legality_format, specify whether a card is legal or restricted.
This is ignored if legality_limit is specified.
ANYPossible values: Get a card with a name that is similar to this string.
Specify the order to return the matching results in.
ASCPossible values: Get a card with a flavor that is similar to this string.
1Specify how many results to include per page.
50Get a cards with any edition's set's prefix included in this list.
Get a card with an edition's rarity that exactly matches this number.
Get a card with a rule whose title or description contains this case-insensitive string.
Get a card with a rule whose title exactly matches this case-insensitive string. "null" can be used to match cards with rules that have no title.
Split each result_edition into its own dedicated data entry. By default all editions shared by cards of the same name are grouped together, however it may be more desirable in some cases to split these editions into their own results.
Get a card with a slug that exactly matches this string.
Get a card whose numeric stats are contained within a semicolon-delimited list of values.
Specify the primary card or edition field the results are sorted by.
collector_numberPossible values: Get cards with any subtype value included in this list.
Use this to adjust how cards are targeted by the subtype query parameter. OR includes any card which includes one or more of the subtype values, whilst AND only matches cards that include all of the specified subtype values.
ORPossible values: Get cards with any type value included in this list.
Use this to adjust how cards are targeted by the type query parameter. OR includes any card which includes one or more of the type values, whilst AND only matches cards that include all of the specified type values.
ORPossible values: GET /cards/search HTTP/1.1
Host: api.gatcg.com
Accept: */*
{
"data": [
{
"classes": [
"WARRIOR"
],
"cost_memory": 1,
"cost_reserve": null,
"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,
"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,
"uuid": "abcde12345"
}
],
"rule": [],
"speed": null,
"slug": "crescent-glaive",
"subtypes": [
"WARRIOR",
"POLEARM"
],
"types": [
"REGALIA",
"WEAPON"
],
"uuid": "abcde12345"
}
],
"has_more": false,
"order": "ASC",
"page": 1,
"page_size": 30,
"paginated_cards_count": 1,
"sort": "collector_number",
"total_cards": 1,
"total_pages": 1
}This returns a list of up to 10 cards which match the given query.
A partial card name to search with.
GlaiveA list of matching cards.
GET /cards/autocomplete HTTP/1.1
Host: api.gatcg.com
Accept: */*
A list of matching cards.
[
{
"classes": [
"WARRIOR"
],
"editions": [
{
"card_id": "abcde12345",
"collector_number": "010",
"effect": null,
"effect_raw": null,
"flavor": "The centerpiece of the Imperial Armory.",
"illustrator": "Dragonart",
"rarity": 1,
"slug": "crescent-glaive-amb",
"uuid": "abcde12345"
}
],
"name": "Crescent Glaive",
"slug": "crescent-glaive",
"subtypes": [
"WARRIOR",
"POLEARM"
],
"types": [
"REGALIA",
"WEAPON"
],
"uuid": "abcde12345"
}
]Quantity of random cards to return.
8GET /cards/random HTTP/1.1
Host: api.gatcg.com
Accept: */*
[
{
"classes": [
"WARRIOR"
],
"cost_memory": 1,
"cost_reserve": null,
"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,
"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,
"uuid": "abcde12345"
}
],
"rule": [],
"speed": null,
"slug": "crescent-glaive",
"subtypes": [
"WARRIOR",
"POLEARM"
],
"types": [
"REGALIA",
"WEAPON"
],
"uuid": "abcde12345"
}
]Last updated