{"openapi":"3.1.0","info":{"title":"Dragon Ball API","version":"1.0.0","description":"The Dragon Ball universe as an API — the characters and planets of Akira Toriyama's saga. Look up a character by name or id (e.g. Goku → Saiyan, Z Fighter, ki 60,000,000, origin planet Vegeta, with all six of his transformations and their power levels) or search and filter the roster by race (Saiyan, Namekian, Frieza Race, Android, Majin, God, Angel and more), affiliation and gender. Browse the planets of the series with their descriptions and destroyed status. Each character carries ki and max ki, race, affiliation, a portrait and the full list of transformations. Backed by the open dragonball-api.com dataset. Ideal for fan sites, trivia and quiz games, power-level calculators, Discord bots and any Dragon Ball app.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/dragonball-api","description":"oanor gateway"}],"tags":[{"name":"Dragon Ball"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/character":{"get":{"operationId":"get_v1_character","tags":["Dragon Ball"],"summary":"A character by id or search/filter","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Character id, e.g. 1 (Goku) — returns transformations","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. Goku","schema":{"type":"string"}},{"name":"race","in":"query","required":false,"description":"Race, e.g. Saiyan, Namekian, Frieza Race, Android","schema":{"type":"string"}},{"name":"affiliation","in":"query","required":false,"description":"Affiliation, e.g. Z Fighter","schema":{"type":"string"}},{"name":"gender","in":"query","required":false,"description":"Male | Female | Unknown","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Page size (1-100, default 10)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"character":{"id":1,"ki":"60.000.000","name":"Goku","race":"Saiyan","image":"https://dragonball-api.com/characters/goku_normal.webp","gender":"Male","max_ki":"90 Septillion","affiliation":"Z Fighter","description":"El protagonista de la serie, conocido por su gran poder y personalidad amigable. Originalmente enviado a la Tierra como un infante volador con la misión de conquistarla. Sin embargo, el caer por un barranco le proporcionó un brutal golpe que si bien casi lo mata, este alteró su memoria y anuló todos los instintos violentos de su especie, lo que lo hizo crecer con un corazón puro y bondadoso, pero conservando todos los poderes de su raza. No obstante, en la nueva continuidad de Dragon Ball se establece que él fue enviado por sus padres a la Tierra con el objetivo de sobrevivir a toda costa a la destrucción de su planeta por parte de Freeza. Más tarde, Kakarot, ahora conocido como Son Goku, se convertiría en el príncipe consorte del monte Fry-pan y líder de los Guerreros Z, así como el mayor defensor de la Tierra y del Universo 7, logrando mantenerlos a salvo de la destrucción en innumerables ocasiones, a pesar de no considerarse a sí mismo como un héroe o salvador.","origin_planet":"Vegeta","transformations":[{"ki":"3 Billion","name":"Goku SSJ"},{"ki":"6 Billion","name":"Goku SSJ2"},{"ki":"24 Billion","name":"Goku SSJ3"},{"ki":"2 Quadrillion","name":"Goku SSJ4"},{"ki":"9 Quintillion","name":"Goku SSJB"},{"ki":"90 Septillion","name":"Goku Ultra Instinc"}]}},"meta":{"timestamp":"2026-06-01T00:04:28.378Z","request_id":"fc3a57e2-12ba-4be1-aeec-a99ef1b0ad1e"},"status":"ok","message":"Character retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/planet":{"get":{"operationId":"get_v1_planet","tags":["Dragon Ball"],"summary":"A planet by id, or the list","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Planet id for detail","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Name search","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Page size (1-100, default 10)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"count":10,"total":20,"planets":[{"id":1,"name":"Namek","image":"https://dragonball-api.com/planetas/Namek_U7.webp","description":"Planeta natal de los Namekianos. Escenario de importantes batallas y la obtención de las Dragon Balls de Namek.","is_destroyed":true},{"id":2,"name":"Tierra","image":"https://dragonball-api.com/planetas/Tierra_Dragon_Ball_Z.webp","description":"La Tierra también llamado Mundo del Dragón (Dragon World), es el planeta principal donde se desarrolla la serie de Dragon Ball. Se encuentra en el Sistema Solar de la Vía Láctea de las Galaxias del Norte del Universo 7, lugar que supervisa el Kaio del Norte, y tiene su equivalente en el Universo 6. El hogar de los terrícolas y los Guerreros Z. Ha sido atacado en varias ocasiones por enemigos poderosos.","is_destroyed":false},{"id":3,"name":"Vegeta","image":"https://dragonball-api.com/planetas/Planeta_Vegeta_en_Dragon_Ball_Super_Broly.webp","description":"El planeta Vegeta, conocido como planeta Plant antes del fin de la Guerra Saiyan-tsufruiana en el año 730, es un planeta rocoso ficticio de la serie de manga y anime Dragon Ball y localizado en la Vía Láctea de las Galaxias del Norte del Universo 7 hasta su destrucción a manos de Freezer en los años 737-739. Planeta natal de los Saiyans, destruido por Freezer. Anteriormente conocido como Planeta Plant.","is_destroyed":true},{"id":4,"name":"Freezer No. 79","image":"https://dragonball-api.com/planetas/PlanetaFreezer.webp","description":"Planeta artificial utilizado por Freezer como base de operaciones y centro de clonación.","is_destroyed":true},{"id":5,"name":"Kanassa","image":"https://dragonball-api.com/planetas/800px-PlanetKannasa.webp","description":"Planeta habitado por los Kanassans y conocido por la lucha entre Bardock y los habitantes del planeta.","is_destroyed":true},{"id":6,"name":"Monmar","image":"https://dragonball-api.com/planetas/monmar.webp","description":"Planeta donde Gohan y Krillin encontraron las Dragon Balls para revivir a sus amigos durante la Saga de Namek.","is_destroyed":false},{"id":7,"name":"Yardrat","image":"https://dragonball-api.com/planetas/PlanetYardrat.webp","description":"Planeta de la técnica Instant Transmission, aprendida por Goku durante su estancia.","is_destroyed":false},{"id":11,"name":"Kaiō del Norte","image":"https://dragonball-api.com/planetas/Planeta_del_Kaio_del_Norte.webp","description":"El Planeta Kaio se encuentra al final del largo Camino de la Serpiente. Es donde viven el Kaio del Norte, su mascota Bubbles, al que utiliza como parte de su entrenamiento, y Gregory.","is_destroyed":false},{"id":13,"name":"Makyo","image":"https://dragonball-api.com/planetas/Makyo_Star.webp","description":"Makyo es un planeta y la fuente de alimentación de todos los malévolos, especialmente Garlic Jr., que solo aparece durante el Arco de Garlic Jr. de Dragon Ball Z.","is_destroyed":false},{"id":14,"name":"Babari","image":"https://dragonball-api.com/planetas/Planeta_Babari.webp","description":"Planeta habitado por los Babari, es un planeta telúrico del Universo 10 donde residen los babarianos, hizo su primera aparición en el episodio 54 de Dragon Ball Super. Es donde Tarble, el hermano de Vegeta, se refugió.","is_destroyed":false}]},"meta":{"timestamp":"2026-06-01T00:04:28.475Z","request_id":"4b72778f-8f0c-4dba-806e-87fdf702b732"},"status":"ok","message":"Planet retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Races, affiliations & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Dragon Ball universe. /v1/character = a character by id or search/filter (name, race, affiliation, gender) — with ki, max ki, origin planet and transformations (e.g. name=Goku → Saiyan, Z Fighter, 6 transformations); /v1/planet = a planet by id or the list. Add page & limit to paginate.","races":["Saiyan","Namekian","Human","Majin","Frieza Race","Android","Jiren Race","God","Angel","Evil","Nucleico","Unknown"],"source":"dragonball-api.com","endpoints":["/v1/character","/v1/planet","/v1/meta"],"affiliations":["Z Fighter","Red Ribbon Army","Namekian Warrior","Freelancer","Army of Frieza","Pride Troopers","Assistant of Vermouth","Villain","Other"]},"meta":{"timestamp":"2026-06-01T00:04:28.545Z","request_id":"d654b394-79dc-4488-b028-7eb08bdd276c"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10200,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":290,"monthly_call_quota":148000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1030,"monthly_call_quota":690000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3170,"monthly_call_quota":2830000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/dragonball-api"}