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
curl -G "https://api.tcggraph.com/v1/cards" \
-d game=dragon-ball-super \
-d limit=5 \
-H "Authorization: Bearer $TCGGRAPH_KEY"{
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.
| Field | Type | Description |
|---|---|---|
| line | Enum | fusion-world or masters. |
| cardType | Enum | LEADER, BATTLE, EXTRA, UNISON, the Z- variants, or ENERGY MARKER. |
| colors | [String] | Red, Blue, Green, Yellow, Black or White; two for multicolour cards. |
| cost | Int | Energy cost to play. |
| specifiedCost | Int | How much of the cost must be paid in the card's colour. |
| power | Int | Battle power; the front face for Leaders. |
| comboPower | Int | Power added when played as a combo. |
| comboEnergy | Int | Masters only: energy the combo costs. |
| specialTraits | [String] | Saiyan, Android, God, Namekian… |
| characters | [String] | Masters only: the characters the card depicts. |
| era | String | Masters only: the saga the card is drawn from. |
| series | String | Masters only: the product series, e.g. Unison Warrior Series — Vermilion Bloodline. |
| back | Object | A 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=SaiyanCheap 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=pricesMasters 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=BATTLEGlossary
Dragon Ball Super terms, and the fields that hold them
What players call a thing on the left, what you query on the right.
| Term | Field | Notes |
|---|---|---|
| Line | gameData.line | fusion-world or masters. The two do not share a card pool. |
| Card type | gameData.cardType | LEADER, BATTLE, EXTRA and UNISON, plus Masters' Z-Leader, Z-Battle and Z-Extra. |
| Cost / specified cost | gameData.specifiedCost | Total energy to play, and how much of it must be the card's colour. |
| Power | gameData.power | Battle power of the front face. Null on Extra cards. |
| Combo power | gameData.comboPower | Power added when the card is played from hand as a combo. Masters adds comboEnergy, the energy that combo costs. |
| Special traits | gameData.specialTraits[] | Saiyan, Android, God, Namekian, Frieza Clan and so on. The main tribal axis. |
| Back | gameData.back | A 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.