Skip to content
Prepaid, no subscription trap. Top up a balance and we draw the monthly fee from it.
tcggraph

Bandai · since 2017

Dragon Ball Super Card Game API

Both lines of the game — Fusion World and the original Masters series — with cost, specified cost, power, combo values, special traits and awakened leader backs.

0
Cards
0
Printings
0
Sets
1
Languages
English

Overview

What the Dragon Ball Super dataset covers

Bandai runs the Dragon Ball Super Card Game as two lines: Fusion World, the 2024 relaunch, and Masters, the original 2017 game that is still releasing new boosters. TCGGraph holds both in one catalogue from Bandai's own card databases: every Leader, Battle, Extra and Unison card with its cost, specified cost, power, combo power and combo energy, colours, special traits, character and era, and for Leaders the awakened back face as its own set of stats and text.

Fusion World and Masters share one schema, so a query over Saiyan leaders spans both lines; a card's line is a field, not a separate game.

Formats

  • Fusion World Standard
  • Masters Standard

Price sources

  • Cardmarket
  • TCGplayer
REST
curl -G "https://api.tcggraph.com/v1/cards" \
  -d game=dragon-ball-super \
  -d limit=5 \
  -H "Authorization: Bearer $TCGGRAPH_KEY"
GraphQL
{
  cards(
    filter: {
      game: DRAGON_BALL_SUPER
      gameData: { line: "fusion-world", cardType: "LEADER", specialTraits: "Saiyan" }
    }
  ) {
    nodes {
      name
      gameData
      prices { source market currency }
    }
  }
}

Schema

Dragon Ball Super-specific fields

Every card carries the shared core fields. These live under gameData, in REST and GraphQL alike, and each is a filter: ?cost=2 in REST, gameData: { cost: 2 } in GraphQL.

FieldTypeDescription
lineEnumfusion-world or masters.
cardTypeEnumLEADER, BATTLE, EXTRA, UNISON, the Z- variants, or ENERGY MARKER.
colors[String]Red, Blue, Green, Yellow, Black or White; two for multicolour cards.
costIntEnergy cost to play.
specifiedCostIntHow much of the cost must be paid in the card's colour.
powerIntBattle power; the front face for Leaders.
comboPowerIntPower added when played as a combo.
comboEnergyIntMasters only: energy the combo costs.
specialTraits[String]Saiyan, Android, God, Namekian…
characters[String]Masters only: the characters the card depicts.
eraStringMasters only: the saga the card is drawn from.
seriesStringMasters only: the product series, e.g. Unison Warrior Series — Vermilion Bloodline.
backObjectA Leader's awakened face: name, power, text and image.

Plus 20 core fields shared by every game — see the full reference.

Sets

Notable Dragon Ball Super sets

  • FB01

    Awakened Pulse

    140 cards · 2024-02-23

  • BT1

    Galactic Battle

    114 cards · 2017-07-28

  • FB11

    Brightness of Hope

    123 cards · 2026-10-16

Modelling

Working with Dragon Ball Super data

The decisions that catch people out when they first integrate Dragon Ball Super. Each of these is a bug we have watched somebody ship.

  • Two lines, one game

    Fusion World (2024) and Masters (2017) are separate games at the table: different rules, different card pools, decks do not mix. Both are game=dragon-ball-super here, with line telling them apart. Filter on it whenever you build for one of them, or a Fusion World deck check will happily accept a Masters card with the same name.

  • A Leader is one printing with two faces

    Leaders awaken during the game and flip to a stronger back face with its own name, power and text. The catalogue keeps that on back rather than as a second card, so a Leader has one id, one price and one image pair. Read back.power when you mean the awakened side.

  • Cost is two numbers

    cost is the total energy to play a card; specifiedCost is how much of it must be paid in the card's own colour. A cost-4 card with specifiedCost 1 sits comfortably in a two-colour deck; the same card with specifiedCost 4 does not. Curves that use cost alone hide the difference.

  • Parallel printings share a number

    Alternate-art and special-rare printings carry the same card number as the regular card with a suffix on the id — dbs_fb01_001_p1 next to dbs_fb01_001, or _spr on Masters. They are the same card for deck building and very different cards for pricing, so group by collector number when you mean the card.

Recipes

Common Dragon Ball Super queries

Three requests that cover most of what applications in this game actually ask for.

Fusion World Leaders with a given trait

Every deck starts from a Leader; list the ones a Saiyan build can use.

specialTraits is an array, so the filter matches any card that carries the trait.

GET /v1/cards
  ?game=dragon-ball-super
  &line=fusion-world
  &cardType=LEADER
  &specialTraits=Saiyan

Cheap red Battle cards

The early curve of a mono-red list.

colors is an array too; a Red/Blue card matches colors=Red and colors=Blue alike.

GET /v1/cards
  ?game=dragon-ball-super
  &line=fusion-world
  &cardType=BATTLE
  &colors=Red
  &cost=2
  &include=prices

Masters cards from one era

Themed decks and collectors both work by saga.

era and characters exist on Masters cards only; Fusion World cards return null for both.

GET /v1/cards
  ?game=dragon-ball-super
  &line=masters
  &era=Universe%20Survival%20Saga
  &cardType=BATTLE

Glossary

Dragon Ball Super terms, and the fields that hold them

What players call a thing on the left, what you query on the right.

TermFieldNotes
LinegameData.linefusion-world or masters. The two do not share a card pool.
Card typegameData.cardTypeLEADER, BATTLE, EXTRA and UNISON, plus Masters' Z-Leader, Z-Battle and Z-Extra.
Cost / specified costgameData.specifiedCostTotal energy to play, and how much of it must be the card's colour.
PowergameData.powerBattle power of the front face. Null on Extra cards.
Combo powergameData.comboPowerPower added when the card is played from hand as a combo. Masters adds comboEnergy, the energy that combo costs.
Special traitsgameData.specialTraits[]Saiyan, Android, God, Namekian, Frieza Clan and so on. The main tribal axis.
BackgameData.backA Leader's awakened face: name, power, text and its own image.

FAQ

Dragon Ball Super API questions

Anything not covered here, email hello@tcggraph.com and a human who knows Dragon Ball Super answers.

Also available

Add another game without another integration

Your Dragon Ball Super key already works for every other game in the catalog. Change the DRAGON_BALL_SUPER enum and the rest of your code stays as it is.