{"openapi":"3.1.0","info":{"title":"D&D 5e API","version":"1.0.0","description":"The complete Dungeons & Dragons 5th-edition System Reference Document as an API — spells, monsters, classes, subclasses, races, backgrounds, equipment, magic items, conditions, features, feats, skills and the full rules reference. Look up a spell by name (e.g. Fireball → 3rd-level evocation, 150 ft, 8d6 fire) or a monster statblock (e.g. Adult Red Dragon → CR 17, AC 19, 256 HP, legendary actions), list and filter any resource type (spells by level or school, monsters by challenge rating), or fetch full detail for any of the 24 SRD categories. Backed by the open dnd5eapi.co dataset. Ideal for character builders, virtual tabletops, encounter and spell-card generators, Discord bots and homebrew tools.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/dnd-api","description":"oanor gateway"}],"tags":[{"name":"SRD"},{"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/get":{"get":{"operationId":"get_v1_get","tags":["SRD"],"summary":"Full detail for any resource by type + index","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"Resource type, e.g. classes","schema":{"type":"string"},"example":"classes"},{"name":"index","in":"query","required":true,"description":"Resource index slug, e.g. wizard","schema":{"type":"string"},"example":"wizard"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"classes","resource":{"url":"/api/2014/classes/wizard","name":"Wizard","index":"wizard","spells":"/api/2014/classes/wizard/spells","hit_die":6,"subclasses":[{"url":"/api/2014/subclasses/evocation","name":"Evocation","index":"evocation"}],"updated_at":"2026-04-01T20:35:36.453Z","class_levels":"/api/2014/classes/wizard/levels","spellcasting":{"info":[{"desc":["At 1st level, you know three cantrips of your choice from the wizard spell list. You learn additional wizard cantrips of your choice at higher levels, as shown in the Cantrips Known column of the Wizard table."],"name":"Cantrips"},{"desc":["At 1st level, you have a spellbook containing six 1st- level wizard spells of your choice. Your spellbook is the repository of the wizard spells you know, except your cantrips, which are fixed in your mind."],"name":"Spellbook"},{"desc":["The Wizard table shows how many spell slots you have to cast your spells of 1st level and higher. To cast one of these spells, you must expend a slot of the spell's level or higher. You regain all expended spell slots when you finish a long rest.","You prepare the list of wizard spells that are available for you to cast. To do so, choose a number of wizard spells from your spellbook equal to your Intelligence modifier + your wizard level (minimum of one spell). The spells must be of a level for which you have spell slots.","For example, if you're a 3rd-level wizard, you have four 1st-level and two 2nd-level spell slots. With an Intelligence of 16, your list of prepared spells can include six spells of 1st or 2nd level, in any combination, chosen from your spellbook. If you prepare the 1st-level spell magic missile, you can cast it using a 1st-level or a 2nd-level slot. Casting the spell doesn't remove it from your list of prepared spells.","You can change your list of prepared spells when you finish a long rest. Preparing a new list of wizard spells requires time spent studying your spellbook and memorizing the incantations and gestures you must make to cast the spell: at least 1 minute per spell level for each spell on your list."],"name":"Preparing and Casting Spells"},{"desc":["Intelligence is your spellcasting ability for your wizard spells, since you learn your spells through dedicated study and memorization. You use your Intelligence whenever a spell refers to your spellcasting ability. In addition, you use your Intelligence modifier when setting the saving throw DC for a wizard spell you cast and when making an attack roll with one.","Spell save DC = 8 + your proficiency bonus + your Intelligence modifier.","Spell attack modifier = your proficiency bonus + your Intelligence modifier."],"name":"Spellcasting Ability"},{"desc":["You can cast a wizard spell as a ritual if that spell has the ritual tag and you have the spell in your spellbook. You don't need to have the spell prepared."],"name":"Ritual Casting"},{"desc":["You can use an arcane focus as a spellcasting focus for your wizard spells."],"name":"Spellcasting Focus"}],"level":1,"spellcasting_ability":{"url":"/api/2014/ability-scores/int","name":"INT","index":"int"}},"proficiencies":[{"url":"/api/2014/proficiencies/daggers","name":"Daggers","index":"daggers"},{"url":"/api/2014/proficiencies/darts","name":"Darts","index":"darts"},{"url":"/api/2014/proficiencies/slings","name":"Slings","index":"slings"},{"url":"/api/2014/proficiencies/quarterstaffs","name":"Quarterstaffs","index":"quarterstaffs"},{"url":"/api/2014/proficiencies/crossbows-light","name":"Crossbows, light","index":"crossbows-light"},{"url":"/api/2014/proficiencies/saving-throw-int","name":"Saving Throw: INT","index":"saving-throw-int"},{"url":"/api/2014/proficiencies/saving-throw-wis","name":"Saving Throw: WIS","index":"saving-throw-wis"}],"saving_throws":[{"url":"/api/2014/ability-scores/int","name":"INT","index":"int"},{"url":"/api/2014/ability-scores/wis","name":"WIS","index":"wis"}],"multi_classing":{"prerequisites":[{"ability_score":{"url":"/api/2014/ability-scores/int","name":"INT","index":"int"},"minimum_score":13}],"proficiencies":[]},"starting_equipment":[{"quantity":1,"equipment":{"url":"/api/2014/equipment/spellbook","name":"Spellbook","index":"spellbook"}}],"proficiency_choices":[{"desc":"Choose two from Arcana, History, Insight, Investigation, Medicine, and Religion","from":{"options":[{"item":{"url":"/api/2014/proficiencies/skill-arcana","name":"Skill: Arcana","index":"skill-arcana"},"option_type":"reference"},{"item":{"url":"/api/2014/proficiencies/skill-history","name":"Skill: History","index":"skill-history"},"option_type":"reference"},{"item":{"url":"/api/2014/proficiencies/skill-insight","name":"Skill: Insight","index":"skill-insight"},"option_type":"reference"},{"item":{"url":"/api/2014/proficiencies/skill-investigation","name":"Skill: Investigation","index":"skill-investigation"},"option_type":"reference"},{"item":{"url":"/api/2014/proficiencies/skill-medicine","name":"Skill: Medicine","index":"skill-medicine"},"option_type":"reference"},{"item":{"url":"/api/2014/proficiencies/skill-religion","name":"Skill: Religion","index":"skill-religion"},"option_type":"reference"}],"option_set_type":"options_array"},"type":"proficiencies","choose":2}],"starting_equipment_options":[{"desc":"(a) a quarterstaff or (b) a dagger","from":{"options":[{"of":{"url":"/api/2014/equipment/quarterstaff","name":"Quarterstaff","index":"quarterstaff"},"count":1,"option_type":"counted_reference"},{"of":{"url":"/api/2014/equipment/dagger","name":"Dagger","index":"dagger"},"count":1,"option_type":"counted_reference"}],"option_set_type":"options_array"},"type":"equipment","choose":1},{"desc":"(a) a component pouch or (b) an arcane focus","from":{"options":[{"of":{"url":"/api/2014/equipment/component-pouch","name":"Component pouch","index":"component-pouch"},"count":1,"option_type":"counted_reference"},{"choice":{"desc":"arcane focus","from":{"option_set_type":"equipment_category","equipment_category":{"url":"/api/2014/equipment-categories/arcane-foci","name":"Arcane Foci","index":"arcane-foci"}},"type":"equipment","choose":1},"option_type":"choice"}],"option_set_type":"options_array"},"type":"equipment","choose":1},{"desc":"(a) a scholar’s pack or (b) an explorer’s pack","from":{"options":[{"of":{"url":"/api/2014/equipment/scholars-pack","name":"Scholar's Pack","index":"scholars-pack"},"count":1,"option_type":"counted_reference"},{"of":{"url":"/api/2014/equipment/explorers-pack","name":"Explorer's Pack","index":"explorers-pack"},"count":1,"option_type":"counted_reference"}],"option_set_type":"options_array"},"type":"equipment","choose":1}]}},"meta":{"timestamp":"2026-06-01T00:04:39.196Z","request_id":"0c91c86f-68dc-4655-8a4d-b8fdb308c7b2"},"status":"ok","message":"Resource 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/list":{"get":{"operationId":"get_v1_list","tags":["SRD"],"summary":"List / filter any resource type","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"Resource type, e.g. spells, monsters, classes, races, equipment","schema":{"type":"string"},"example":"spells"},{"name":"level","in":"query","required":false,"description":"Spell level filter 0-9 (type=spells)","schema":{"type":"string"},"example":"3"},{"name":"school","in":"query","required":false,"description":"Magic school filter (type=spells), e.g. evocation","schema":{"type":"string"}},{"name":"challenge_rating","in":"query","required":false,"description":"CR filter (type=monsters), e.g. 17","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Name search","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"spells","count":42,"results":[{"name":"Animate Dead","index":"animate-dead"},{"name":"Beacon of Hope","index":"beacon-of-hope"},{"name":"Bestow Curse","index":"bestow-curse"},{"name":"Blink","index":"blink"},{"name":"Call Lightning","index":"call-lightning"},{"name":"Clairvoyance","index":"clairvoyance"},{"name":"Conjure Animals","index":"conjure-animals"},{"name":"Counterspell","index":"counterspell"},{"name":"Create Food and Water","index":"create-food-and-water"},{"name":"Daylight","index":"daylight"},{"name":"Dispel Magic","index":"dispel-magic"},{"name":"Fear","index":"fear"},{"name":"Fireball","index":"fireball"},{"name":"Fly","index":"fly"},{"name":"Gaseous Form","index":"gaseous-form"},{"name":"Glyph of Warding","index":"glyph-of-warding"},{"name":"Haste","index":"haste"},{"name":"Hypnotic Pattern","index":"hypnotic-pattern"},{"name":"Lightning Bolt","index":"lightning-bolt"},{"name":"Magic Circle","index":"magic-circle"},{"name":"Major Image","index":"major-image"},{"name":"Mass Healing Word","index":"mass-healing-word"},{"name":"Meld Into Stone","index":"meld-into-stone"},{"name":"Nondetection","index":"nondetection"},{"name":"Phantom Steed","index":"phantom-steed"},{"name":"Plant Growth","index":"plant-growth"},{"name":"Protection From Energy","index":"protection-from-energy"},{"name":"Remove Curse","index":"remove-curse"},{"name":"Revivify","index":"revivify"},{"name":"Sending","index":"sending"},{"name":"Sleet Storm","index":"sleet-storm"},{"name":"Slow","index":"slow"},{"name":"Speak with Dead","index":"speak-with-dead"},{"name":"Speak with Plants","index":"speak-with-plants"},{"name":"Spirit Guardians","index":"spirit-guardians"},{"name":"Stinking Cloud","index":"stinking-cloud"},{"name":"Tiny Hut","index":"tiny-hut"},{"name":"Tongues","index":"tongues"},{"name":"Vampiric Touch","index":"vampiric-touch"},{"name":"Water Breathing","index":"water-breathing"},{"name":"Water Walk","index":"water-walk"},{"name":"Wind Wall","index":"wind-wall"}]},"meta":{"timestamp":"2026-06-01T00:04:39.371Z","request_id":"9dcb6e38-4fc7-4518-a7a2-34aeef15a240"},"status":"ok","message":"Resources listed","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/monster":{"get":{"operationId":"get_v1_monster","tags":["SRD"],"summary":"A monster statblock by index or name","description":"","parameters":[{"name":"index","in":"query","required":false,"description":"Monster index slug, e.g. adult-red-dragon","schema":{"type":"string"},"example":"adult-red-dragon"},{"name":"q","in":"query","required":false,"description":"Monster name to resolve","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"monster":{"xp":18000,"name":"Adult Red Dragon","size":"Huge","type":"dragon","index":"adult-red-dragon","speed":{"fly":"80 ft.","walk":"40 ft.","climb":"40 ft."},"senses":{"blindsight":"60 ft.","darkvision":"120 ft.","passive_perception":23},"actions":[{"desc":"The dragon can use its Frightful Presence. It then makes three attacks: one with its bite and two with its claws.","name":"Multiattack"},{"desc":"Melee Weapon Attack: +14 to hit, reach 10 ft., one target. Hit: 19 (2d10 + 8) piercing damage plus 7 (2d6) fire damage.","name":"Bite"},{"desc":"Melee Weapon Attack: +14 to hit, reach 5 ft., one target. Hit: 15 (2d6 + 8) slashing damage.","name":"Claw"},{"desc":"Melee Weapon Attack: +14 to hit, reach 15 ft., one target. Hit: 17 (2d8 + 8) bludgeoning damage.","name":"Tail"},{"desc":"Each creature of the dragon's choice that is within 120 ft. of the dragon and aware of it must succeed on a DC 19 Wisdom saving throw or become frightened for 1 minute. A creature can repeat the saving throw at the end of each of its turns, ending the effect on itself on a success. If a creature's saving throw is successful or the effect ends for it, the creature is immune to the dragon's Frightful Presence for the next 24 hours.","name":"Frightful Presence"},{"desc":"The dragon exhales fire in a 60-foot cone. Each creature in that area must make a DC 21 Dexterity saving throw, taking 63 (18d6) fire damage on a failed save, or half as much damage on a successful one.","name":"Fire Breath"}],"hit_dice":"19d12","abilities":{"cha":21,"con":25,"dex":10,"int":16,"str":27,"wis":13},"alignment":"chaotic evil","languages":"Common, Draconic","hit_points":256,"armor_class":[{"type":"natural","value":19}],"challenge_rating":17,"legendary_actions":[{"desc":"The dragon makes a Wisdom (Perception) check.","name":"Detect"},{"desc":"The dragon makes a tail attack.","name":"Tail Attack"},{"desc":"The dragon beats its wings. Each creature within 10 ft. of the dragon must succeed on a DC 22 Dexterity saving throw or take 15 (2d6 + 8) bludgeoning damage and be knocked prone. The dragon can then fly up to half its flying speed.","name":"Wing Attack (Costs 2 Actions)"}],"proficiency_bonus":6,"special_abilities":[{"desc":"If the dragon fails a saving throw, it can choose to succeed instead.","name":"Legendary Resistance"}]}},"meta":{"timestamp":"2026-06-01T00:04:39.557Z","request_id":"27e31a86-6e30-437f-9169-10e45a757714"},"status":"ok","message":"Monster 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/spell":{"get":{"operationId":"get_v1_spell","tags":["SRD"],"summary":"A spell by index or name","description":"","parameters":[{"name":"index","in":"query","required":false,"description":"Spell index slug, e.g. fireball","schema":{"type":"string"},"example":"fireball"},{"name":"q","in":"query","required":false,"description":"Spell name to resolve, e.g. Fireball","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"spell":{"dc":{"dc_type":{"url":"/api/2014/ability-scores/dex","name":"DEX","index":"dex"},"dc_success":"half"},"name":"Fireball","index":"fireball","level":3,"range":"150 feet","damage":{"damage_type":{"url":"/api/2014/damage-types/fire","name":"Fire","index":"fire"},"damage_at_slot_level":{"3":"8d6","4":"9d6","5":"10d6","6":"11d6","7":"12d6","8":"13d6","9":"14d6"}},"ritual":false,"school":"Evocation","classes":["Sorcerer","Wizard"],"duration":"Instantaneous","material":"A tiny ball of bat guano and sulfur.","components":["V","S","M"],"subclasses":["Lore","Fiend"],"description":"A bright streak flashes from your pointing finger to a point you choose within range and then blossoms with a low roar into an explosion of flame. Each creature in a 20-foot-radius sphere centered on that point must make a dexterity saving throw. A target takes 8d6 fire damage on a failed save, or half as much damage on a successful one.\n\nThe fire spreads around corners. It ignites flammable objects in the area that aren't being worn or carried.","casting_time":"1 action","higher_level":"When you cast this spell using a spell slot of 4th level or higher, the damage increases by 1d6 for each slot level above 3rd.","concentration":false,"area_of_effect":{"size":20,"type":"sphere"}}},"meta":{"timestamp":"2026-06-01T00:04:39.715Z","request_id":"851e1063-b34f-403e-b95a-9110bb288621"},"status":"ok","message":"Spell 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":"Resource types & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Dungeons & Dragons 5e SRD. /v1/spell = a spell by index or name (e.g. index=fireball or q=Fireball); /v1/monster = a monster statblock (e.g. index=adult-red-dragon); /v1/list = list/filter any resource type (type=spells&level=3&school=evocation, type=monsters&challenge_rating=17, or name= to search); /v1/get = full detail for any type+index (type=classes&index=wizard). Types: spells, monsters, classes, races, equipment, magic-items, conditions, features, feats and more.","types":["ability-scores","alignments","backgrounds","classes","conditions","damage-types","equipment","equipment-categories","feats","features","languages","magic-items","magic-schools","monsters","proficiencies","races","rule-sections","rules","skills","spells","subclasses","subraces","traits","weapon-properties"],"source":"dnd5eapi.co (D&D 5e SRD, 2014)","endpoints":["/v1/spell","/v1/monster","/v1/list","/v1/get","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:39.783Z","request_id":"e0253c24-4437-4fb4-84cb-491be88fc328"},"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":6000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":440,"monthly_call_quota":90000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1340,"monthly_call_quota":450000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3590,"monthly_call_quota":2200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/dnd-api"}