Strength
STR
Measures physical power, carrying capacity, and effectiveness in brute-force actions such as lifting, pushing, and melee attacks.
Related skills
Guild grimoire
Choose a chapter from the codex
Open a chapter to study the lore behind each API resource. The first pages are already inked, while the sealed chapters will be expanded as the project grows.
Attributes are the six core ability scores used to describe the natural strengths of a character in the Adventurers Guild API.
Expected return
Response shape
The endpoint returns a list of attributes. Each item follows the same shape, making it easy to read the field meaning before using the JSON response in the rest of the project.
Unique numeric identifier for the attribute.
numberFull attribute name, such as Strength or Dexterity.
stringShort attribute code used across character data.
stringAPI description explaining what the attribute represents.
stringSkill names currently associated with this attribute.
string[]Example JSON
200 OK[
{
"id": 1,
"name": "Strength",
"shortname": "STR",
"description": "Measures physical power, carrying capacity, and effectiveness in brute-force actions such as lifting, pushing, and melee attacks.",
"skills": [
"Athletics"
]
},
{
"id": 2,
"name": "Dexterity",
"shortname": "DEX",
"description": "Measures agility, reflexes, balance, and coordination. It affects actions that require speed, precision, and stealth.",
"skills": [
"Acrobatics",
"Sleight of Hand",
"Stealth"
]
},
{
"id": 3,
"name": "Constitution",
"shortname": "CON",
"description": "Measures endurance, resilience, and physical toughness. It is commonly associated with health, stamina, and resistance to harm.",
"skills": []
},
{
"id": 4,
"name": "Intelligence",
"shortname": "INT",
"description": "Measures reasoning, memory, knowledge, and analytical ability. It is linked to learning, investigation, and logical thinking.",
"skills": [
"Arcana",
"History",
"Investigation",
"Nature",
"Religion"
]
},
{
"id": 5,
"name": "Wisdom",
"shortname": "WIS",
"description": "Measures perception, intuition, awareness, and good judgment. It reflects how well a character understands the world around them.",
"skills": [
"Animal Handling",
"Insight",
"Medicine",
"Perception",
"Survival"
]
},
{
"id": 6,
"name": "Charisma",
"shortname": "CHA",
"description": "Measures presence, confidence, influence, and social impact. It affects persuasion, leadership, and interpersonal interactions.",
"skills": [
"Deception",
"Intimidation",
"Performance",
"Persuasion"
]
}
]Skills represent practical ways a character applies an attribute. Each skill has a related attribute, a description, an example of use, and common classes that often benefit from it.
Acrobatics
Represents agility, balance, and coordination.
Example of use
Used when performing flips, dodging, or maintaining balance.Related attribute
DEXExpected return
Response shape
The list endpoint returns a compact array of skills. Each item includes only the identifier and the skill name, while the detail endpoint exposes the richer educational fields.
List response
GET /api/skillsUnique numeric identifier for the skill.
numberSkill name returned in the compact skill list.
stringExample JSON
200 OK[
{
"id": 2,
"name": "Acrobatics"
},
{
"id": 10,
"name": "Animal Handling"
},
{
"id": 5,
"name": "Arcana"
},
{
"id": 1,
"name": "Athletics"
},
{
"id": 15,
"name": "Deception"
},
{
"id": 6,
"name": "History"
},
{
"id": 11,
"name": "Insight"
},
{
"id": 16,
"name": "Intimidation"
},
{
"id": 7,
"name": "Investigation"
},
{
"id": 12,
"name": "Medicine"
},
{
"id": 8,
"name": "Nature"
},
{
"id": 13,
"name": "Perception"
},
{
"id": 17,
"name": "Performance"
},
{
"id": 18,
"name": "Persuasion"
},
{
"id": 9,
"name": "Religion"
},
{
"id": 3,
"name": "Sleight of Hand"
},
{
"id": 4,
"name": "Stealth"
},
{
"id": 14,
"name": "Survival"
}
]Detail response
GET /api/skills/{identifier}Unique numeric identifier for the skill.
numberSkill name used as the readable identifier.
stringShort name of the related attribute, such as STR or DEX.
stringAPI description explaining what the skill represents.
stringShort gameplay example for when this skill is used.
stringClass names commonly associated with this skill.
string[]Example JSON
200 OK{
"id": 1,
"name": "Athletics",
"attribute": "STR",
"description": "Represents physical capability in actions such as climbing, jumping, swimming, or forcing objects through strength.",
"exampleofuse": "Used when a character tries to climb a castle wall or force open a heavy gate.",
"commonclasses": [
"Fighter",
"Barbarian",
"Paladin",
"Ranger"
]
}Classes describe a character's adventuring path: their role, hit die, core attributes, saving throw proficiencies, recommended skills, and spellcasting support.
melee
Barbarian
A fierce warrior who relies on raw strength and primal fury to overcome enemies.
What this class grants
- Hit dieD12
- Primary abilities
- Saving throws
- Skill proficiency choicesChoose 2 skills from this class list.
- Recommended skills
- Weapon proficienciesSimple Weapons, Martial Weapons
- Armor proficienciesLight Armor, Medium Armor, Shield
- SubclassesBerserker, Wild Heart, World Tree, Zealot
- Equipment options
Option A
- Greataxe
- 4 Handaxes
- Explorer's Pack
- 15 GP
Option B
- 75 GP
Class progression
Features returned by the class detail endpoint.| Level | Feature | Description |
|---|---|---|
| 1 | Rage | You can imbue yourself with a primal power called Rage, a force that grants you extraordinary might and resilience. You can enter it as a Bonus Action if you aren’t wearing Heavy armor. You can enter your Rage the number of times shown for your Barbarian level in the Rages column of the Barbarian Features table. You regain one expended use when you finish a Short Rest, and you regain all expended uses when you finish a Long Rest. While active, your Rage follows the rules below. Damage Resistance. You have Resistance to Bludgeoning, Piercing, and Slashing damage. Rage Damage. When you make an attack using Strength—with either a weapon or an Unarmed Strike—and deal damage to the target, you gain a bonus to the damage that increases as you gain levels as a Barbarian, as shown in the Rage Damage column of the Barbarian Features table. Strength Advantage. You have Advantage on Strength checks and Strength saving throws. No Concentration or Spells. You can’t maintain Concentration, and you can’t cast spells. Duration. The Rage lasts until the end of your next turn, and it ends early if you don Heavy armor or have the Incapacitated condition. If your Rage is still active on your next turn, you can extend the Rage for another round by doing one of the following: Make an attack roll against an enemy. Force an enemy to make a saving throw. Take a Bonus Action to extend your Rage. Each time the Rage is extended, it lasts until the end of your next turn. You can maintain a Rage for up to 10 minutes. |
| 1 | Unarmored Defense | While you aren’t wearing any armor, your base Armor Class equals 10 plus your Dexterity and Constitution modifiers. You can use a Shield and still gain this benefit. |
| 1 | Weapon Mastery | Your training with weapons allows you to use the mastery properties of two kinds of Simple or Martial Melee weapons of your choice, such as Greataxes and Handaxes. Whenever you finish a Long Rest, you can practice weapon drills and change one of those weapon choices. When you reach certain Barbarian levels, you gain the ability to use the mastery properties of more kinds of weapons, as shown in the Weapon Mastery column of the Barbarian Features table. |
| 2 | Danger Sense | You gain an uncanny sense of when things aren’t as they should be, giving you an edge when you dodge perils. You have Advantage on Dexterity saving throws unless you have the Incapacitated condition. |
| 2 | Reckless Attack | You can throw aside all concern for defense to attack with increased ferocity. When you make your first attack roll on your turn, you can decide to attack recklessly. Doing so gives you Advantage on attack rolls using Strength until the start of your next turn, but attack rolls against you have Advantage during that time. |
| 3 | Barbarian Subclass | You gain a Barbarian subclass of your choice. The Path of the Berserker subclass is detailed after this class’s description. A subclass is a specialization that grants you features at certain Barbarian levels. For the rest of your career, you gain each of your subclass’s features that are of your Barbarian level or lower. |
| 3 | Primal Knowledge | You gain proficiency in another skill of your choice from the skill list available to Barbarians at level 1. In addition, while your Rage is active, you can channel primal power when you attempt certain tasks; whenever you make an ability check using one of the following skills, you can make it as a Strength check even if it normally uses a different ability: Acrobatics, Intimidation, Perception, Stealth, or Survival. When you use this ability, your Strength represents primal power coursing through you, honing your agility, bearing, and senses. |
| 4 | Ability Score Improvement | You gain the Ability Score Improvement feat (see “Feats”) or another feat of your choice for which you qualify. You gain this feature again at Barbarian levels 8, 12, and 16. |
| 5 | Extra Attack | You can attack twice instead of once whenever you take the Attack action on your turn. |
| 5 | Fast Movement | Your speed increases by 10 feet while you aren’t wearing Heavy armor. |
| 7 | Feral Instinct | Your instincts are so honed that you have Advantage on Initiative rolls. |
| 7 | Instinctive Pounce | As part of the Bonus Action you take to enter your Rage, you can move up to half your Speed. |
| 9 | Brutal Strike | If you use Reckless Attack, you can forgo any Advantage on one Strength-based attack roll of your choice on your turn. The chosen attack roll mustn’t have Disadvantage. If the chosen attack roll hits, the target takes an extra 1d10 damage of the same type dealt by the weapon or Unarmed Strike, and you can cause one Brutal Strike effect of your choice. You have the following effect options. Forceful Blow. The target is pushed 15 feet straight away from you. You can then move up to half your Speed straight toward the target without provoking Opportunity Attacks. Hamstring Blow. The target’s Speed is reduced by 15 feet until the start of your next turn. A target can be affected by only one Hamstring Blow at a time—the most recent one. |
| 11 | Relentless Rage | Your Rage can keep you fighting despite grievous wounds. If you drop to 0 Hit Points while your Rage is active and don’t die outright, you can make a DC 10 Constitution saving throw. If you succeed, your Hit Points instead change to a number equal to twice your Barbarian level. Each time you use this feature after the first, the DC increases by 5. When you finish a Short or Long Rest, the DC resets to 10. |
| 13 | Improved Brutal Strike | You have honed new ways to attack furiously. The following effects are now among your Brutal Strike options. Staggering Blow. The target has Disadvantage on the next saving throw it makes, and it can’t make Opportunity Attacks until the start of your next turn. Sundering Blow. Before the start of your next turn, the next attack roll made by another creature against the target gains a +5 bonus to the roll. An attack roll can gain only one Sundering Blow bonus. |
| 15 | Persistent Rage | When you roll Initiative, you can regain all expended uses of Rage. After you regain uses of Rage in this way, you can’t do so again until you finish a Long Rest. In addition, your Rage is so fierce that it now lasts for 10 minutes without you needing to do anything to extend it from round to round. Your Rage ends early if you have the Unconscious condition (not just the Incapacitated condition) or don Heavy armor. |
| 17 | Improved Brutal Strike | The extra damage of your Brutal Strike increases to 2d10. In addition, you can use two different Brutal Strike effects whenever you use your Brutal Strike feature. |
| 18 | Indomitable Might | If your total for a Strength check or Strength saving throw is less than your Strength score, you can use that score in place of the total. |
| 19 | Epic Boon | You gain an Epic Boon feat (see “Feats”) or another feat of your choice for which you qualify. Boon of Irresistible Offense is recommended. |
| 20 | Primal Champion | You embody primal power. Your Strength and Constitution scores increase by 4, to a maximum of 25. |
Species describe a character's ancestry and physical profile in the Adventurers Guild API. This chapter will grow into a guide for creature type, size, speed, and special traits returned by the species endpoints.
Humanoid
Aasimar
Aasimar are mortals who carry a spark of the Upper Planes within their souls, marked by celestial heritage and able to reveal heavenly power.
Size
Medium or SmallSpeed
30 ft.Special traits
- Celestial ResistanceYou have Resistance to Necrotic damage and Radiant damage.
- DarkvisionYou have Darkvision with a range of 60 feet.
- Healing HandsAs a Magic action, you touch a creature and roll a number of d4s equal to your Proficiency Bonus. The creature regains a number of Hit Points equal to the total rolled. Once you use this trait, you cannot use it again until you finish a Long Rest.
- Light BearerYou know the Light cantrip. Charisma is your spellcasting ability for it.
- Celestial RevelationWhen you reach character level 3, you can transform as a Bonus Action using Heavenly Wings, Inner Radiance, or Necrotic Shroud. The transformation lasts for 1 minute or until you end it. Once on each of your turns before the transformation ends, you can deal extra damage to one target when you deal damage to it with an attack or a spell. The extra damage equals your Proficiency Bonus and is Necrotic for Necrotic Shroud or Radiant for Heavenly Wings and Inner Radiance. Once you transform, you cannot do so again until you finish a Long Rest.
- Heavenly WingsTwo spectral wings sprout from your back temporarily. Until the transformation ends, you have a Fly Speed equal to your Speed.
- Inner RadianceSearing light temporarily radiates from your eyes and mouth. For the duration, you shed Bright Light in a 10-foot radius and Dim Light for an additional 10 feet, and at the end of each of your turns, each creature within 10 feet of you takes Radiant damage equal to your Proficiency Bonus.
- Necrotic ShroudYour eyes briefly become pools of darkness, and flightless wings sprout from your back temporarily. Creatures other than your allies within 10 feet of you must succeed on a Charisma saving throw (DC 8 plus your Charisma modifier and Proficiency Bonus) or have the Frightened condition until the end of your next turn.
Expected return
Response shape
The list endpoint returns a compact species index with only identifiers and names. Use the detail endpoint when you need creature type, size, speed, traits, and subspecies.
List response
GET /api/speciesUnique numeric identifier for the species.
numberSpecies name returned in the compact species list.
stringExample JSON
200 OK[
{
"id": 10,
"name": "Aasimar"
},
{
"id": 1,
"name": "Dragonborn"
},
{
"id": 2,
"name": "Dwarf"
},
{
"id": 3,
"name": "Elf"
},
{
"id": 4,
"name": "Gnome"
},
{
"id": 5,
"name": "Goliath"
},
{
"id": 6,
"name": "Halfling"
},
{
"id": 7,
"name": "Human"
},
{
"id": 8,
"name": "Orc"
},
{
"id": 9,
"name": "Tiefling"
}
]Detail response: Elf
GET /api/species/elfUnique numeric identifier for the species.
numberReadable species name, such as Elf or Dragonborn.
stringURL-friendly identifier accepted by the detail endpoint.
stringShort lore and gameplay description for the species.
stringCreature classification returned by the API.
stringDefault physical size category for the species.
stringBase movement speed in feet.
numberTraits granted by the base species.
SpeciesTrait[]Optional lineage variants and their own traits.
SpeciesSubspecies[]Example JSON
200 OK{
"id": 3,
"name": "Elf",
"slug": "elf",
"description": "Created by the god Corellon, the first elves could change their forms at will. They lost this ability when Corellon cursed them for plotting with the deity Lolth, who tried and failed to usurp Corellon’s dominion. When Lolth was cast into the Abyss, most elves renounced her and earned Corellon’s forgiveness, but that which Corellon had taken from them was lost forever.\n\nNo longer able to shape-shift at will, the elves retreated to the Feywild, where their sorrow was deepened by that plane’s influence. Over time, curiosity led many of them to explore other planes of existence, including worlds in the Material Plane.\n\nElves have pointed ears and lack facial and body hair. They live for around 750 years, and they don’t sleep but instead enter a trance when they need to rest. In that state, they remain aware of their surroundings while immersing themselves in memories and meditations.",
"creatureType": "Humanoid",
"size": "Medium",
"speed": 30,
"specialTraits": [
{
"name": "Darkvision",
"description": "You have Darkvision with a range of 60 feet."
},
{
"name": "Elven Lineage",
"description": "Choose a lineage from the Elven Lineages table. You gain the level 1 benefit, and at character levels 3 and 5 you learn additional spells tied to that lineage."
},
{
"name": "Fey Ancestry",
"description": "You have Advantage on saving throws you make to avoid or end the Charmed condition."
},
{
"name": "Keen Senses",
"description": "You have proficiency in the Insight, Perception, or Survival skill."
},
{
"name": "Trance",
"description": "You do not need to sleep, magic cannot put you to sleep, and you can finish a Long Rest in 4 hours through meditation while retaining awareness."
}
],
"subspecies": [
{
"name": "Drow",
"slug": "drow",
"description": "An elven lineage associated with the Underdark and innate magic.",
"specialTraits": [
{
"name": "Level 1",
"description": "The range of your Darkvision increases to 120 feet. You also know the Dancing Lights cantrip."
},
{
"name": "Level 3",
"description": "You can cast Faerie Fire."
},
{
"name": "Level 5",
"description": "You can cast Darkness."
}
]
},
{
"name": "High Elf",
"slug": "high-elf",
"description": "A magical elven lineage with an arcane cantrip and additional arcane magic.",
"specialTraits": [
{
"name": "Level 1",
"description": "You know the Prestidigitation cantrip. Whenever you finish a Long Rest, you can replace that cantrip with a different cantrip from the Wizard spell list."
},
{
"name": "Level 3",
"description": "You can cast Detect Magic."
},
{
"name": "Level 5",
"description": "You can cast Misty Step."
}
]
},
{
"name": "Wood Elf",
"slug": "wood-elf",
"description": "An elven lineage tied to forests, speed, and primal magic.",
"specialTraits": [
{
"name": "Level 1",
"description": "Your Speed increases to 35 feet. You also know the Druidcraft cantrip."
},
{
"name": "Level 3",
"description": "You can cast Longstrider."
},
{
"name": "Level 5",
"description": "You can cast Pass without Trace."
}
]
},
{
"name": "Lorwyn Elf",
"slug": "lorwyn-elf",
"description": "An elven lineage tied to primal magic from Lorwyn.",
"specialTraits": [
{
"name": "Level 1",
"description": "You know the Thorn Whip cantrip. Whenever you finish a Long Rest, you can replace that cantrip with a different cantrip from the Druid spell list."
},
{
"name": "Level 3",
"description": "You can cast Command."
},
{
"name": "Level 5",
"description": "You can cast Silence."
}
]
},
{
"name": "Shadowmoor Elf",
"slug": "shadowmoor-elf",
"description": "An elven lineage tied to shadowed magic from Shadowmoor.",
"specialTraits": [
{
"name": "Level 1",
"description": "The range of your Darkvision increases to 120 feet. You also know the Starry Wisp cantrip."
},
{
"name": "Level 3",
"description": "You can cast Heroism."
},
{
"name": "Level 5",
"description": "You can cast Gentle Repose."
}
]
}
]
}Backgrounds frame where an adventurer comes from before their first quest, combining identity, proficiencies, and starting gear.
Origin and identity
Acolyte
You devoted yourself to service in a temple, either nestled in a town or secluded in a sacred grove. There you performed rites in honor of a god or pantheon. You served under a priest and studied religion. Thanks to your priest's instruction and your own devotion, you also learned how to channel a modicum of divine power in service to your place of worship and the people who prayed there.
What this background grants
- Tool proficiencyCalligrapher's Supplies
- FeatMagic Initiate (Cleric)
- Ability scores
- Skill proficiencies
- Equipment options
Option 1
- Calligrapher's Supplies
- Book (prayers)
- Holy Symbol
- Parchment (10 sheets)
- Robe
- 8 GP
Option 2
- 50 GP
Expected return
Response shapes
The list endpoint stays compact, while the detail endpoint adds the gameplay fields needed to understand a background.
List response
GET /api/backgroundsUnique numeric identifier for the background.
numberBackground name returned in the compact list response.
stringExample JSON
200 OK[
{
"id": "1",
"name": "Acolyte"
},
{
"id": "3",
"name": "Artisan"
},
{
"id": "4",
"name": "Charlatan"
},
{
"id": "5",
"name": "Criminal"
},
{
"id": "6",
"name": "Entertainer"
},
{
"id": "7",
"name": "Farmer"
},
{
"id": "8",
"name": "Guard"
},
{
"id": "9",
"name": "Guide"
},
{
"id": "10",
"name": "Hermit"
},
{
"id": "11",
"name": "Merchant"
},
{
"id": "12",
"name": "Noble"
},
{
"id": "13",
"name": "Sage"
},
{
"id": "14",
"name": "Sailor"
},
{
"id": "15",
"name": "Scribe"
},
{
"id": "16",
"name": "Soldier"
},
{
"id": "17",
"name": "Wayfarer"
}
]Detail response: Acolyte
GET /api/backgrounds/acolyteUnique numeric identifier for the background.
numberReadable background name.
stringURL-friendly identifier accepted by the detail endpoint.
stringNarrative summary of the background.
stringAbility score options linked to this background.
string[]Feat granted by the background.
stringSkill proficiencies granted by the background.
string[]Optional tool proficiency included in the background.
string | nullStarting equipment options for the background.
string[]Example JSON
200 OK{
"id": "1",
"name": "Acolyte",
"slug": "acolyte",
"description": "You devoted yourself to service in a temple, either nestled in a town or secluded in a sacred grove. There you performed rites in honor of a god or pantheon. You served under a priest and studied religion. Thanks to your priest's instruction and your own devotion, you also learned how to channel a modicum of divine power in service to your place of worship and the people who prayed there.",
"abilityScores": [
"INT",
"WIS",
"CHA"
],
"feat": "Magic Initiate (Cleric)",
"skillProficiencies": [
"Insight",
"Religion"
],
"toolProficiency": "Calligrapher's Supplies",
"equipmentOptions": [
"Calligrapher's Supplies, Book (prayers), Holy Symbol, Parchment (10 sheets), Robe, 8 GP",
"50 GP"
]
}Equipment covers weapons, armor, and adventure gear. This chapter is organized by category so you can learn what each group represents and scan the catalog in table form.
Weapons
Weapons are combat tools used to make melee or ranged attacks. The catalog is split into multiple weapon types so it is easier to compare simpler options against more specialized martial choices.
After the four tables below, we also explain the main weapon properties and mastery concepts shown in the API.
Simple Melee Weapons
Table view for simple melee weapons.| Name | Damage | Properties | Mastery | Weight | Cost |
|---|---|---|---|---|---|
| Club | 1d4 Bludgeoning | Light | Slow | 2 lb. | 1 SP |
| Dagger | 1d4 Piercing | Finesse, Light, Thrown (Range 20/60) | Nick | 1 lb. | 2 gp |
| Greatclub | 1d8 Bludgeoning | Two-Handed | Push | 10 lb. | 2 SP |
| Handaxe | 1d6 Slashing | Light, Thrown (Range 20/60) | Vex | 2 lb. | 5 GP |
| Javelin | 1d6 Piercing | Thrown (Range 30/120) | Slow | 2 lb. | 5 SP |
| Light Hammer | 1d4 Bludgeoning | Light, Thrown (Range 20/60) | Nick | 2 lb. | 2 GP |
| Mace | 1d6 Bludgeoning | — | Sap | 4 lb. | 5 GP |
| Quarterstaff | 1d6 Bludgeoning | Versatile (1d8) | Topple | 4 lb. | 2 sp |
| Sickle | 1d4 Slashing | Light | Nick | 2 lb. | 1 GP |
| Spear | 1d6 Piercing | Thrown (Range 20/60), Versatile (1d8) | Sap | 3 lb. | 1 gp |
Simple Ranged Weapons
Table view for simple ranged weapons.| Name | Damage | Properties | Mastery | Weight | Cost |
|---|---|---|---|---|---|
| Dart | 1d4 Piercing | Finesse, Thrown (Range 20/60) | Vex | 0.25 lb. | 5 CP |
| Light Crossbow | 1d8 Piercing | Ammunition (Range 80/320, Bolt), Loading, Two-Handed | Slow | 5 lb. | 25 gp |
| Shortbow | 1d6 Piercing | Ammunition (Range 80/320, Arrow), Two-Handed | Vex | 2 lb. | 25 GP |
| Sling | 1d4 Bludgeoning | Ammunition (Range 30/120, Bullet) | Slow | Not listed | 1 SP |
Martial Melee Weapons
Table view for martial melee weapons.| Name | Damage | Properties | Mastery | Weight | Cost |
|---|---|---|---|---|---|
| Battleaxe | 1d8 Slashing | Versatile (1d10) | Topple | 4 lb. | 10 GP |
| Flail | 1d8 Bludgeoning | — | Sap | 2 lb. | 10 GP |
| Glaive | 1d10 Slashing | Heavy, Reach, Two-Handed | Graze | 6 lb. | 20 GP |
| Greataxe | 1d12 Slashing | Heavy, Two-Handed | Cleave | 7 lb. | 30 GP |
| Greatsword | 2d6 Slashing | Heavy, Two-Handed | Graze | 6 lb. | 50 GP |
| Halberd | 1d10 Slashing | Heavy, Reach, Two-Handed | Cleave | 6 lb. | 20 GP |
| Lance | 1d10 Piercing | Heavy, Reach, Two-Handed (unless mounted) | Topple | 6 lb. | 10 GP |
| Longsword | 1d8 Slashing | Versatile (1d10) | Sap | 3 lb. | 15 gp |
| Maul | 2d6 Bludgeoning | Heavy, Two-Handed | Topple | 10 lb. | 10 GP |
| Morningstar | 1d8 Piercing | — | Sap | 4 lb. | 15 GP |
| Pike | 1d10 Piercing | Heavy, Reach, Two-Handed | Push | 18 lb. | 5 GP |
| Rapier | 1d8 Piercing | Finesse | Vex | 2 lb. | 25 GP |
| Scimitar | 1d6 Slashing | Finesse, Light | Nick | 3 lb. | 25 GP |
| Shortsword | 1d6 Piercing | Finesse, Light | Vex | 2 lb. | 10 GP |
| Trident | 1d8 Piercing | Thrown (Range 20/60), Versatile (1d10) | Topple | 4 lb. | 5 GP |
| War Pick | 1d8 Piercing | Versatile (1d10) | Sap | 2 lb. | 5 GP |
| Warhammer | 1d8 Bludgeoning | Versatile (1d10) | Push | 5 lb. | 15 GP |
| Whip | 1d4 Slashing | Finesse, Reach | Slow | 3 lb. | 2 GP |
Martial Ranged Weapons
Table view for martial ranged weapons.| Name | Damage | Properties | Mastery | Weight | Cost |
|---|---|---|---|---|---|
| Blowgun | 1 Piercing | Ammunition (Range 25/100, Needle), Loading | Vex | 1 lb. | 10 GP |
| Hand Crossbow | 1d6 Piercing | Ammunition (Range 30/120, Bolt), Light, Loading | Vex | 3 lb. | 75 GP |
| Heavy Crossbow | 1d10 Piercing | Ammunition (Range 100/400, Bolt), Heavy, Loading, Two-Handed | Push | 18 lb. | 50 GP |
| Longbow | 1d8 Piercing | Ammunition (Range 150/600, Arrow), Heavy, Two-Handed | Slow | 2 lb. | 50 gp |
| Musket | 1d12 Piercing | Ammunition (Range 40/120, Bullet), Loading, Two-Handed | Slow | 10 lb. | 500 GP |
| Pistol | 1d10 Piercing | Ammunition (Range 30/90, Bullet), Loading | Vex | 3 lb. | 250 GP |
Properties and Mastery
Weapon properties describe how a weapon behaves in play, such as whether it can be thrown, used with Dexterity, or wielded in two hands.
Weapon mastery is a separate combat concept. It represents the tactical rider tied to a weapon, such as pushing, toppling, or slowing a target after a successful hit.
Weapon glossary
Weapon Properties
Properties describe how a weapon is handled in play. They explain extra rules like throwing distance, finesse use, or two-handed requirements.| Property | Meaning |
|---|---|
| Ammunition | You can use a weapon that has the Ammunition property to make a ranged attack only if you have ammunition to fire from it. The type of ammunition required is specified with the weapon's range. Each attack expends one piece of ammunition. Drawing the ammunition is part of the attack, and you need a free hand to load a one-handed weapon. After a fight, you can spend 1 minute to recover half the ammunition you used, rounded down. |
| Finesse | When making an attack with a Finesse weapon, use your choice of your Strength or Dexterity modifier for the attack and damage rolls. You must use the same modifier for both rolls. |
| Heavy | You have Disadvantage on attack rolls with a Heavy weapon if it's a Melee weapon and your Strength score isn't at least 13, or if it's a Ranged weapon and your Dexterity score isn't at least 13. |
| Light | When you take the Attack action on your turn and attack with a Light weapon, you can make one extra attack as a Bonus Action later on the same turn. That extra attack must be made with a different Light weapon, and you don't add your ability modifier to the extra attack's damage unless that modifier is negative. |
| Loading | You can fire only one piece of ammunition from a Loading weapon when you use an action, a Bonus Action, or a Reaction to fire it, regardless of the number of attacks you can normally make. |
| Reach | A Reach weapon adds 5 feet to your reach when you attack with it, as well as when determining your reach for Opportunity Attacks with it. |
| Thrown | If a weapon has the Thrown property, you can throw the weapon to make a ranged attack, and you can draw that weapon as part of the attack. If the weapon is a Melee weapon, use the same ability modifier for the attack and damage rolls that you use for a melee attack with that weapon. |
| Two-Handed | A Two-Handed weapon requires two hands when you attack with it. |
| Versatile | A Versatile weapon can be used with one or two hands. A damage value in parentheses appears with the property. The weapon deals that damage when used with two hands to make a melee attack. |
Weapon glossary
Weapon Mastery
Mastery is the tactical effect tied to a weapon. It adds an extra combat payoff after a successful hit, such as slowing, toppling, pushing, or pressuring the target.| Mastery | Meaning |
|---|---|
| Cleave | If you hit a creature with a melee attack roll using this weapon, you can make a melee attack roll with the weapon against a second creature within 5 feet of the first that is also within your reach. On a hit, the second creature takes the weapon's damage, but don't add your ability modifier to that damage unless that modifier is negative. You can make this extra attack only once per turn. |
| Graze | If your attack roll with this weapon misses a creature, you can deal damage to that creature equal to the ability modifier you used to make the attack roll. This damage is the same type dealt by the weapon, and it can be increased only by increasing the ability modifier. |
| Nick | When you make the extra attack of the Light property, you can make it as part of the Attack action instead of as a Bonus Action. You can make this extra attack only once per turn. |
| Push | If you hit a creature with this weapon, you can push the creature up to 10 feet straight away from yourself if it is Large or smaller. |
| Sap | If you hit a creature with this weapon, that creature has Disadvantage on its next attack roll before the start of your next turn. |
| Slow | If you hit a creature with this weapon and deal damage to it, you can reduce its Speed by 10 feet until the start of your next turn. If the creature is hit more than once by weapons that have this property, the Speed reduction doesn't exceed 10 feet. |
| Topple | If you hit a creature with this weapon, you can force the creature to make a Constitution saving throw. On a failed save, the creature has the Prone condition. |
| Vex | If you hit a creature with this weapon and deal damage to the creature, you have Advantage on your next attack roll against that creature before the end of your next turn. |
Expected return
Response shapes
The list response stays lightweight, while the detail response exposes the richer item payload used by character and combat flows.
List response
GET /api/equipmentUnique numeric identifier for the equipment item.
numberReadable equipment name returned by the list endpoint.
stringBroad category such as Weapon, Armor, or Adventuring Gear.
stringMore specific type label used to group similar items.
stringCost string exactly as exposed by the API.
stringItem weight in pounds when available.
number | nullWhether the item is marked as magical.
booleanExample JSON
200 OK[
{
"id": "25",
"name": "Acid",
"category": "Adventuring Gear",
"type": "Consumable Gear",
"cost": "25 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "116",
"name": "Airship",
"category": "Mounts and Vehicles",
"type": "Airborne Vehicle",
"cost": "40,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "26",
"name": "Alchemist's Fire",
"category": "Adventuring Gear",
"type": "Consumable Gear",
"cost": "50 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "123",
"name": "Alchemist's Supplies",
"category": "Tools",
"type": "Artisan Tool",
"cost": "50 GP",
"weight": "8.00",
"isMagical": false
},
{
"id": "27",
"name": "Ammunition",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "Varies",
"weight": null,
"isMagical": false
},
{
"id": "28",
"name": "Antitoxin",
"category": "Adventuring Gear",
"type": "Consumable Gear",
"cost": "50 GP",
"weight": null,
"isMagical": false
},
{
"id": "29",
"name": "Arcane Focus",
"category": "Adventuring Gear",
"type": "Spellcasting Focus",
"cost": "Varies",
"weight": null,
"isMagical": false
},
{
"id": "20",
"name": "Arrows",
"category": "Ammunition",
"type": "Arrow Ammunition",
"cost": "1 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "160",
"name": "Assassin's Blood",
"category": "Poison",
"type": "Ingested Poison",
"cost": "150 GP",
"weight": null,
"isMagical": false
},
{
"id": "30",
"name": "Backpack",
"category": "Adventuring Gear",
"type": "Container",
"cost": "2 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "150",
"name": "Bagpipes",
"category": "Tools",
"type": "Musical Instrument",
"cost": "30 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "31",
"name": "Ball Bearings",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "32",
"name": "Barrel",
"category": "Adventuring Gear",
"type": "Container",
"cost": "2 GP",
"weight": "70.00",
"isMagical": false
},
{
"id": "33",
"name": "Basket",
"category": "Adventuring Gear",
"type": "Container",
"cost": "4 SP",
"weight": "2.00",
"isMagical": false
},
{
"id": "184",
"name": "Battleaxe",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "10 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "34",
"name": "Bedroll",
"category": "Adventuring Gear",
"type": "Camping Gear",
"cost": "1 GP",
"weight": "7.00",
"isMagical": false
},
{
"id": "35",
"name": "Bell",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": null,
"isMagical": false
},
{
"id": "36",
"name": "Blanket",
"category": "Adventuring Gear",
"type": "Camping Gear",
"cost": "5 SP",
"weight": "3.00",
"isMagical": false
},
{
"id": "37",
"name": "Block and Tackle",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "201",
"name": "Blowgun",
"category": "Weapon",
"type": "Martial Ranged Weapon",
"cost": "10 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "21",
"name": "Bolts",
"category": "Ammunition",
"type": "Bolt Ammunition",
"cost": "1 GP",
"weight": "1.50",
"isMagical": false
},
{
"id": "39",
"name": "Book",
"category": "Adventuring Gear",
"type": "Reference Item",
"cost": "25 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "40",
"name": "Bottle, Glass",
"category": "Adventuring Gear",
"type": "Container",
"cost": "2 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "7",
"name": "Breastplate",
"category": "Armor",
"type": "Medium Armor",
"cost": "400 gp",
"weight": "20.00",
"isMagical": false
},
{
"id": "124",
"name": "Brewer's Supplies",
"category": "Tools",
"type": "Artisan Tool",
"cost": "20 GP",
"weight": "9.00",
"isMagical": false
},
{
"id": "38",
"name": "Bright Fungal Cloak",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "25 GP",
"weight": null,
"isMagical": false
},
{
"id": "41",
"name": "Bucket",
"category": "Adventuring Gear",
"type": "Container",
"cost": "5 CP",
"weight": "2.00",
"isMagical": false
},
{
"id": "22",
"name": "Bullets, Firearm",
"category": "Ammunition",
"type": "Firearm Ammunition",
"cost": "3 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "23",
"name": "Bullets, Sling",
"category": "Ammunition",
"type": "Sling Ammunition",
"cost": "4 CP",
"weight": "1.50",
"isMagical": false
},
{
"id": "42",
"name": "Burglar's Pack",
"category": "Adventuring Gear",
"type": "Pack",
"cost": "16 GP",
"weight": "42.00",
"isMagical": false
},
{
"id": "161",
"name": "Burnt Othur Fumes",
"category": "Poison",
"type": "Inhaled Poison",
"cost": "500 GP",
"weight": null,
"isMagical": false
},
{
"id": "125",
"name": "Calligrapher's Supplies",
"category": "Tools",
"type": "Artisan Tool",
"cost": "10 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "43",
"name": "Caltrops",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "44",
"name": "Candle",
"category": "Adventuring Gear",
"type": "Light Source",
"cost": "1 CP",
"weight": null,
"isMagical": false
},
{
"id": "126",
"name": "Carpenter's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "8 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "162",
"name": "Carrion Crawler Mucus",
"category": "Poison",
"type": "Contact Poison",
"cost": "200 GP",
"weight": null,
"isMagical": false
},
{
"id": "127",
"name": "Cartographer's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "15 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "45",
"name": "Case, Crossbow Bolt",
"category": "Adventuring Gear",
"type": "Container",
"cost": "1 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "46",
"name": "Case, Map or Scroll",
"category": "Adventuring Gear",
"type": "Container",
"cost": "1 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "47",
"name": "Chain",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "5 GP",
"weight": "10.00",
"isMagical": false
},
{
"id": "10",
"name": "Chain Mail",
"category": "Armor",
"type": "Heavy Armor",
"cost": "75 gp",
"weight": "55.00",
"isMagical": false
},
{
"id": "5",
"name": "Chain Shirt",
"category": "Armor",
"type": "Medium Armor",
"cost": "50 gp",
"weight": "20.00",
"isMagical": false
},
{
"id": "48",
"name": "Chest",
"category": "Adventuring Gear",
"type": "Container",
"cost": "5 GP",
"weight": "25.00",
"isMagical": false
},
{
"id": "49",
"name": "Climber's Kit",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "25 GP",
"weight": "12.00",
"isMagical": false
},
{
"id": "50",
"name": "Clothes, Fine",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "15 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "51",
"name": "Clothes, Traveler's",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "2 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "175",
"name": "Club",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "1 SP",
"weight": "2.00",
"isMagical": false
},
{
"id": "128",
"name": "Cobbler's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "5 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "52",
"name": "Component Pouch",
"category": "Adventuring Gear",
"type": "Spellcasting Focus",
"cost": "25 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "129",
"name": "Cook's Utensils",
"category": "Tools",
"type": "Artisan Tool",
"cost": "1 GP",
"weight": "8.00",
"isMagical": false
},
{
"id": "53",
"name": "Costume",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "5 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "54",
"name": "Crowbar",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "2 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "14",
"name": "Dagger",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "2 gp",
"weight": "1.00",
"isMagical": false
},
{
"id": "182",
"name": "Dart",
"category": "Weapon",
"type": "Simple Ranged Weapon",
"cost": "5 CP",
"weight": "0.25",
"isMagical": false
},
{
"id": "146",
"name": "Dice",
"category": "Tools",
"type": "Gaming Set",
"cost": "1 SP",
"weight": null,
"isMagical": false
},
{
"id": "140",
"name": "Disguise Kit",
"category": "Tools",
"type": "Other Tool",
"cost": "25 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "147",
"name": "Dragonchess",
"category": "Tools",
"type": "Gaming Set",
"cost": "1 GP",
"weight": null,
"isMagical": false
},
{
"id": "151",
"name": "Drum",
"category": "Tools",
"type": "Musical Instrument",
"cost": "6 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "152",
"name": "Dulcimer",
"category": "Tools",
"type": "Musical Instrument",
"cost": "25 GP",
"weight": "10.00",
"isMagical": false
},
{
"id": "163",
"name": "Essence of Ether",
"category": "Poison",
"type": "Inhaled Poison",
"cost": "300 GP",
"weight": null,
"isMagical": false
},
{
"id": "185",
"name": "Flail",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "10 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "153",
"name": "Flute",
"category": "Tools",
"type": "Musical Instrument",
"cost": "2 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "141",
"name": "Forgery Kit",
"category": "Tools",
"type": "Other Tool",
"cost": "15 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "117",
"name": "Galley",
"category": "Mounts and Vehicles",
"type": "Waterborne Vehicle",
"cost": "30,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "186",
"name": "Glaive",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "20 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "130",
"name": "Glassblower's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "30 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "187",
"name": "Greataxe",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "30 GP",
"weight": "7.00",
"isMagical": false
},
{
"id": "176",
"name": "Greatclub",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "2 SP",
"weight": "10.00",
"isMagical": false
},
{
"id": "188",
"name": "Greatsword",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "50 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "189",
"name": "Halberd",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "20 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "8",
"name": "Half Plate Armor",
"category": "Armor",
"type": "Medium Armor",
"cost": "750 gp",
"weight": "40.00",
"isMagical": false
},
{
"id": "202",
"name": "Hand Crossbow",
"category": "Weapon",
"type": "Martial Ranged Weapon",
"cost": "75 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "177",
"name": "Handaxe",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "5 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "203",
"name": "Heavy Crossbow",
"category": "Weapon",
"type": "Martial Ranged Weapon",
"cost": "50 GP",
"weight": "18.00",
"isMagical": false
},
{
"id": "142",
"name": "Herbalism Kit",
"category": "Tools",
"type": "Other Tool",
"cost": "5 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "4",
"name": "Hide Armor",
"category": "Armor",
"type": "Medium Armor",
"cost": "10 gp",
"weight": "12.00",
"isMagical": false
},
{
"id": "154",
"name": "Horn",
"category": "Tools",
"type": "Musical Instrument",
"cost": "3 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "70",
"name": "Ink",
"category": "Adventuring Gear",
"type": "Writing Supplies",
"cost": "10 GP",
"weight": null,
"isMagical": false
},
{
"id": "71",
"name": "Ink Pen",
"category": "Adventuring Gear",
"type": "Writing Supplies",
"cost": "2 CP",
"weight": null,
"isMagical": false
},
{
"id": "178",
"name": "Javelin",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "5 SP",
"weight": "2.00",
"isMagical": false
},
{
"id": "131",
"name": "Jeweler's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "25 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "72",
"name": "Jug",
"category": "Adventuring Gear",
"type": "Container",
"cost": "2 CP",
"weight": "4.00",
"isMagical": false
},
{
"id": "118",
"name": "Keelboat",
"category": "Mounts and Vehicles",
"type": "Waterborne Vehicle",
"cost": "3,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "73",
"name": "Ladder",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 SP",
"weight": "25.00",
"isMagical": false
},
{
"id": "74",
"name": "Lamp",
"category": "Adventuring Gear",
"type": "Light Source",
"cost": "5 SP",
"weight": "1.00",
"isMagical": false
},
{
"id": "190",
"name": "Lance",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "10 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "75",
"name": "Lantern, Bullseye",
"category": "Adventuring Gear",
"type": "Light Source",
"cost": "10 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "76",
"name": "Lantern, Hooded",
"category": "Adventuring Gear",
"type": "Light Source",
"cost": "5 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "2",
"name": "Leather Armor",
"category": "Armor",
"type": "Light Armor",
"cost": "10 gp",
"weight": "10.00",
"isMagical": false
},
{
"id": "132",
"name": "Leatherworker's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "5 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "17",
"name": "Light Crossbow",
"category": "Weapon",
"type": "Simple Ranged Weapon",
"cost": "25 gp",
"weight": "5.00",
"isMagical": false
},
{
"id": "179",
"name": "Light Hammer",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "2 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "77",
"name": "Lock",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "10 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "78",
"name": "Locking Spellbook",
"category": "Adventuring Gear",
"type": "Reference Item",
"cost": "35 GP",
"weight": null,
"isMagical": false
},
{
"id": "164",
"name": "Lolth's Sting",
"category": "Poison",
"type": "Injury Poison",
"cost": "200 GP",
"weight": null,
"isMagical": false
},
{
"id": "19",
"name": "Longbow",
"category": "Weapon",
"type": "Martial Ranged Weapon",
"cost": "50 gp",
"weight": "2.00",
"isMagical": false
},
{
"id": "119",
"name": "Longship",
"category": "Mounts and Vehicles",
"type": "Waterborne Vehicle",
"cost": "10,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "18",
"name": "Longsword",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "15 gp",
"weight": "3.00",
"isMagical": false
},
{
"id": "155",
"name": "Lute",
"category": "Tools",
"type": "Musical Instrument",
"cost": "35 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "156",
"name": "Lyre",
"category": "Tools",
"type": "Musical Instrument",
"cost": "30 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "180",
"name": "Mace",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "5 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "79",
"name": "Magnifying Glass",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "100 GP",
"weight": null,
"isMagical": false
},
{
"id": "165",
"name": "Malice",
"category": "Poison",
"type": "Inhaled Poison",
"cost": "250 GP",
"weight": null,
"isMagical": false
},
{
"id": "80",
"name": "Manacles",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "2 GP",
"weight": "6.00",
"isMagical": false
},
{
"id": "81",
"name": "Map",
"category": "Adventuring Gear",
"type": "Reference Item",
"cost": "1 GP",
"weight": null,
"isMagical": false
},
{
"id": "133",
"name": "Mason's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "10 GP",
"weight": "8.00",
"isMagical": false
},
{
"id": "191",
"name": "Maul",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "10 GP",
"weight": "10.00",
"isMagical": false
},
{
"id": "166",
"name": "Midnight Tears",
"category": "Poison",
"type": "Ingested Poison",
"cost": "1,500 GP",
"weight": null,
"isMagical": false
},
{
"id": "82",
"name": "Mirror",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "5 GP",
"weight": "0.50",
"isMagical": false
},
{
"id": "83",
"name": "Monster Camouflage",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "50 GP",
"weight": null,
"isMagical": false
},
{
"id": "192",
"name": "Morningstar",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "15 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "204",
"name": "Musket",
"category": "Weapon",
"type": "Martial Ranged Weapon",
"cost": "500 GP",
"weight": "10.00",
"isMagical": false
},
{
"id": "143",
"name": "Navigator's Tools",
"category": "Tools",
"type": "Other Tool",
"cost": "25 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "24",
"name": "Needles",
"category": "Ammunition",
"type": "Needle Ammunition",
"cost": "1 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "84",
"name": "Net",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "85",
"name": "Oil",
"category": "Adventuring Gear",
"type": "Consumable Gear",
"cost": "1 SP",
"weight": "1.00",
"isMagical": false
},
{
"id": "167",
"name": "Oil of Taggit",
"category": "Poison",
"type": "Contact Poison",
"cost": "400 GP",
"weight": null,
"isMagical": false
},
{
"id": "1",
"name": "Padded Armor",
"category": "Armor",
"type": "Light Armor",
"cost": "5 gp",
"weight": "8.00",
"isMagical": false
},
{
"id": "134",
"name": "Painter's Supplies",
"category": "Tools",
"type": "Artisan Tool",
"cost": "10 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "168",
"name": "Pale Tincture",
"category": "Poison",
"type": "Ingested Poison",
"cost": "250 GP",
"weight": null,
"isMagical": false
},
{
"id": "157",
"name": "Pan Flute",
"category": "Tools",
"type": "Musical Instrument",
"cost": "12 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "86",
"name": "Paper",
"category": "Adventuring Gear",
"type": "Writing Supplies",
"cost": "2 SP",
"weight": null,
"isMagical": false
},
{
"id": "87",
"name": "Parchment",
"category": "Adventuring Gear",
"type": "Writing Supplies",
"cost": "1 SP",
"weight": null,
"isMagical": false
},
{
"id": "88",
"name": "Perfume",
"category": "Adventuring Gear",
"type": "Consumable Gear",
"cost": "5 GP",
"weight": null,
"isMagical": false
},
{
"id": "193",
"name": "Pike",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "5 GP",
"weight": "18.00",
"isMagical": false
},
{
"id": "205",
"name": "Pistol",
"category": "Weapon",
"type": "Martial Ranged Weapon",
"cost": "250 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "12",
"name": "Plate Armor",
"category": "Armor",
"type": "Heavy Armor",
"cost": "1500 gp",
"weight": "65.00",
"isMagical": false
},
{
"id": "148",
"name": "Playing Cards",
"category": "Tools",
"type": "Gaming Set",
"cost": "5 SP",
"weight": null,
"isMagical": false
},
{
"id": "89",
"name": "Poison, Basic",
"category": "Adventuring Gear",
"type": "Poison",
"cost": "100 GP",
"weight": null,
"isMagical": false
},
{
"id": "144",
"name": "Poisoner's Kit",
"category": "Tools",
"type": "Other Tool",
"cost": "50 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "90",
"name": "Pole",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "5 CP",
"weight": "7.00",
"isMagical": false
},
{
"id": "91",
"name": "Pot, Iron",
"category": "Adventuring Gear",
"type": "Container",
"cost": "2 GP",
"weight": "10.00",
"isMagical": false
},
{
"id": "92",
"name": "Potion of Healing",
"category": "Adventuring Gear",
"type": "Potion",
"cost": "50 GP",
"weight": "0.50",
"isMagical": true
},
{
"id": "135",
"name": "Potter's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "10 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "93",
"name": "Pouch",
"category": "Adventuring Gear",
"type": "Container",
"cost": "5 SP",
"weight": "1.00",
"isMagical": false
},
{
"id": "94",
"name": "Priest's Pack",
"category": "Adventuring Gear",
"type": "Pack",
"cost": "33 GP",
"weight": "29.00",
"isMagical": false
},
{
"id": "169",
"name": "Purple Worm Poison",
"category": "Poison",
"type": "Injury Poison",
"cost": "2,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "15",
"name": "Quarterstaff",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "2 sp",
"weight": "4.00",
"isMagical": false
},
{
"id": "95",
"name": "Quiver",
"category": "Adventuring Gear",
"type": "Container",
"cost": "1 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "96",
"name": "Ram, Portable",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "4 GP",
"weight": "35.00",
"isMagical": false
},
{
"id": "194",
"name": "Rapier",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "25 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "97",
"name": "Rations",
"category": "Adventuring Gear",
"type": "Consumable Gear",
"cost": "5 SP",
"weight": "2.00",
"isMagical": false
},
{
"id": "9",
"name": "Ring Mail",
"category": "Armor",
"type": "Heavy Armor",
"cost": "30 gp",
"weight": "40.00",
"isMagical": false
},
{
"id": "98",
"name": "Robe",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "1 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "99",
"name": "Rope",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "120",
"name": "Rowboat",
"category": "Mounts and Vehicles",
"type": "Waterborne Vehicle",
"cost": "50 GP",
"weight": null,
"isMagical": false
},
{
"id": "100",
"name": "Sack",
"category": "Adventuring Gear",
"type": "Container",
"cost": "1 CP",
"weight": "0.50",
"isMagical": false
},
{
"id": "121",
"name": "Sailing Ship",
"category": "Mounts and Vehicles",
"type": "Waterborne Vehicle",
"cost": "10,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "6",
"name": "Scale Mail",
"category": "Armor",
"type": "Medium Armor",
"cost": "50 gp",
"weight": "45.00",
"isMagical": false
},
{
"id": "101",
"name": "Scholar's Pack",
"category": "Adventuring Gear",
"type": "Pack",
"cost": "40 GP",
"weight": "22.00",
"isMagical": false
},
{
"id": "195",
"name": "Scimitar",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "25 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "170",
"name": "Serpent Venom",
"category": "Poison",
"type": "Injury Poison",
"cost": "200 GP",
"weight": null,
"isMagical": false
},
{
"id": "158",
"name": "Shawm",
"category": "Tools",
"type": "Musical Instrument",
"cost": "2 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "13",
"name": "Shield",
"category": "Armor",
"type": "Shield",
"cost": "10 gp",
"weight": "6.00",
"isMagical": false
},
{
"id": "174",
"name": "Shortbow",
"category": "Weapon",
"type": "Simple Ranged Weapon",
"cost": "25 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "196",
"name": "Shortsword",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "10 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "102",
"name": "Shovel",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "2 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "181",
"name": "Sickle",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "1 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "103",
"name": "Signal Whistle",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "5 CP",
"weight": null,
"isMagical": false
},
{
"id": "183",
"name": "Sling",
"category": "Weapon",
"type": "Simple Ranged Weapon",
"cost": "1 SP",
"weight": null,
"isMagical": false
},
{
"id": "136",
"name": "Smith's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "20 GP",
"weight": "8.00",
"isMagical": false
},
{
"id": "16",
"name": "Spear",
"category": "Weapon",
"type": "Simple Melee Weapon",
"cost": "1 gp",
"weight": "3.00",
"isMagical": false
},
{
"id": "104",
"name": "Spell Scroll (Cantrip)",
"category": "Adventuring Gear",
"type": "Scroll",
"cost": "30 GP",
"weight": null,
"isMagical": true
},
{
"id": "105",
"name": "Spell Scroll (Level 1)",
"category": "Adventuring Gear",
"type": "Scroll",
"cost": "50 GP",
"weight": null,
"isMagical": true
},
{
"id": "106",
"name": "Spikes, Iron",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "11",
"name": "Splint Armor",
"category": "Armor",
"type": "Heavy Armor",
"cost": "200 gp",
"weight": "60.00",
"isMagical": false
},
{
"id": "107",
"name": "Spyglass",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1,000 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "108",
"name": "String",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "1 SP",
"weight": null,
"isMagical": false
},
{
"id": "3",
"name": "Studded Leather Armor",
"category": "Armor",
"type": "Light Armor",
"cost": "45 gp",
"weight": "13.00",
"isMagical": false
},
{
"id": "109",
"name": "Tent",
"category": "Adventuring Gear",
"type": "Camping Gear",
"cost": "2 GP",
"weight": "20.00",
"isMagical": false
},
{
"id": "145",
"name": "Thieves' Tools",
"category": "Tools",
"type": "Other Tool",
"cost": "25 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "149",
"name": "Three-dragon Ante",
"category": "Tools",
"type": "Gaming Set",
"cost": "1 GP",
"weight": null,
"isMagical": false
},
{
"id": "110",
"name": "Tinderbox",
"category": "Adventuring Gear",
"type": "Utility Gear",
"cost": "5 SP",
"weight": "1.00",
"isMagical": false
},
{
"id": "137",
"name": "Tinker's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "50 GP",
"weight": "10.00",
"isMagical": false
},
{
"id": "111",
"name": "Torch",
"category": "Adventuring Gear",
"type": "Light Source",
"cost": "1 CP",
"weight": "1.00",
"isMagical": false
},
{
"id": "171",
"name": "Torpor",
"category": "Poison",
"type": "Ingested Poison",
"cost": "600 GP",
"weight": null,
"isMagical": false
},
{
"id": "197",
"name": "Trident",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "5 GP",
"weight": "4.00",
"isMagical": false
},
{
"id": "172",
"name": "Truth Serum",
"category": "Poison",
"type": "Ingested Poison",
"cost": "150 GP",
"weight": null,
"isMagical": false
},
{
"id": "112",
"name": "Vial",
"category": "Adventuring Gear",
"type": "Container",
"cost": "1 GP",
"weight": null,
"isMagical": false
},
{
"id": "159",
"name": "Viol",
"category": "Tools",
"type": "Musical Instrument",
"cost": "30 GP",
"weight": "1.00",
"isMagical": false
},
{
"id": "199",
"name": "War Pick",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "5 GP",
"weight": "2.00",
"isMagical": false
},
{
"id": "198",
"name": "Warhammer",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "15 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "113",
"name": "Warm Fungal Clothing",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "15 GP",
"weight": null,
"isMagical": false
},
{
"id": "122",
"name": "Warship",
"category": "Mounts and Vehicles",
"type": "Waterborne Vehicle",
"cost": "25,000 GP",
"weight": null,
"isMagical": false
},
{
"id": "114",
"name": "Waterskin",
"category": "Adventuring Gear",
"type": "Container",
"cost": "2 SP",
"weight": "5.00",
"isMagical": false
},
{
"id": "138",
"name": "Weaver's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "1 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "200",
"name": "Whip",
"category": "Weapon",
"type": "Martial Melee Weapon",
"cost": "2 GP",
"weight": "3.00",
"isMagical": false
},
{
"id": "115",
"name": "Winter Camouflage",
"category": "Adventuring Gear",
"type": "Clothing",
"cost": "50 GP",
"weight": null,
"isMagical": false
},
{
"id": "139",
"name": "Woodcarver's Tools",
"category": "Tools",
"type": "Artisan Tool",
"cost": "1 GP",
"weight": "5.00",
"isMagical": false
},
{
"id": "173",
"name": "Wyvern Poison",
"category": "Poison",
"type": "Injury Poison",
"cost": "1,200 GP",
"weight": null,
"isMagical": false
}
]Detail response: Battleaxe
GET /api/equipment/battleaxeUnique numeric identifier for the equipment item.
numberReadable equipment name.
stringURL-friendly identifier accepted by the detail endpoint.
stringBroad category of the item.
stringSpecific equipment type.
stringNarrative and gameplay description of the item.
stringItem cost string as returned by the API.
stringItem weight in pounds when known.
number | nullWhether the item is magical.
booleanStructured bonuses applied by the item.
EquipmentModifier[]Additional effects attached to the item.
EquipmentEffect[]Typed detail payload that varies by equipment kind.
EquipmentDetailsExample JSON
200 OK{
"id": "184",
"name": "Battleaxe",
"slug": "battleaxe",
"category": "Weapon",
"type": "Martial Melee Weapon",
"description": "A broad-bladed fighting axe.",
"cost": "10 GP",
"weight": "4.00",
"isMagical": false,
"modifiers": [],
"effects": [],
"details": {
"kind": "weapon",
"range": null,
"damage": {
"dice": [
{
"count": 1,
"value": 8
}
],
"bonus": 0,
"formula": "1d8",
"damageType": "Slashing"
},
"mastery": {
"name": "Topple",
"slug": "topple"
},
"attackType": "Melee",
"properties": [
{
"name": "Versatile",
"slug": "versatile",
"damage": {
"dice": [
{
"count": 1,
"value": 10
}
],
"bonus": 0,
"formula": "1d10",
"damageType": "Slashing"
}
}
],
"ammunitionType": null,
"weaponCategory": "Martial",
"proficiencyType": "Martial Weapons",
"versatileDamage": {
"dice": [
{
"count": 1,
"value": 10
}
],
"bonus": 0,
"formula": "1d10",
"damageType": "Slashing"
}
}
}Spells are grouped by level so you can compare cantrips and leveled magic more easily before drilling into a specific spell detail response.
Spellbook tools
Filter the spellbook
Level
Class
School
Casting Time
Duration
Components
Concentration
Search by word
Choose a level, class, school, or search term to load spells.
All
Table view for spells currently listed under this spell level after the active filters are applied.| Name | Level | School | Classes | Casting Time | Range | Components | Duration |
|---|---|---|---|---|---|---|---|
| Choose a level, class, school, or search term to load spells. | |||||||
Spell glossary
Reading the spellbook
Spells mix filtering language and rules language. This glossary keeps the core terms close to the table so readers can understand what each column and filter is describing.| Term | Meaning |
|---|---|
| Spell level | The power band of the spell. Level 0 spells are cantrips, while Levels 1 through 9 represent increasingly stronger spell slots and effects. |
| School | The magical discipline the spell belongs to, such as Evocation, Illusion, or Necromancy. Schools help organize spells by their role and flavor. |
| Casting time | How long it takes to cast the spell. Common values include Action, Bonus Action, Reaction, and longer ritual or minute-based timings. |
| Range | How far the spell can reach, or whether it targets yourself, a touched creature, or a point at a distance. |
| Components | The verbal, somatic, and material requirements needed to cast the spell. These are often abbreviated as V, S, and M in rules text. |
| Concentration | A concentration spell stays active only while the caster maintains focus. Taking damage or casting another concentration spell can end it early. |
| Duration | How long the spell remains active after being cast, from instantaneous effects to rounds, minutes, hours, or longer ongoing magic. |
| Classes | The classes that normally have access to the spell in the Adventurers Guild API spell list. |
Expected return
Response shapes
The list response is intentionally lightweight even when filters are applied, so the browser can search quickly without pulling full descriptions, classes, source text, or scaling data on every request. The detail response is where the richer spellcasting context lives.
List response
GET /api/spellsUnique numeric identifier for the spell.
numberDisplay name used in indexes and spell selection flows.
stringSpell level, where 0 represents a cantrip.
numberFriendly label for the spell level.
stringDetail response: Acid Splash
GET /api/spells/acid-splashUnique numeric identifier for the spell.
numberSpell name.
stringStable text identifier for slug-based lookups.
stringSource book or ruleset reference.
stringMagic school classification, such as Evocation or Illusion.
stringSpell level, where 0 is a cantrip.
numberFriendly label for the spell level.
stringHow long it takes to cast the spell.
stringCasting distance or targeting range.
stringVerbal, somatic, and material casting requirements.
SpellComponentsHow long the spell lasts after being cast.
stringFull spell rules text.
stringClasses that can normally access the spell.
string[]Optional scaling entries for stronger versions of the spell.
SpellScaling | nullExample JSON
200 OK{
"id": 1,
"name": "Acid Splash",
"slug": "acid-splash",
"source": "Player's Handbook",
"school": "Evocation",
"level": 0,
"levelLabel": "Cantrip",
"castingTime": "Action",
"range": "60 feet",
"components": {
"verbal": true,
"somatic": true,
"material": false,
"materialDescription": null,
"summary": "V, S"
},
"duration": "Instantaneous",
"description": "You create an acidic bubble at a point within range, where it explodes in a 5-foot-radius Sphere. Each creature in that Sphere must succeed on a Dexterity saving throw or take 1d6 Acid damage.",
"classes": [
"Sorcerer",
"Wizard"
],
"scaling": {
"entries": [
{
"level": 5,
"description": "damage increases to 2d6"
},
{
"level": 11,
"description": "damage increases to 3d6"
},
{
"level": 17,
"description": "damage increases to 4d6"
}
]
}
}Auth is the gateway chapter for protected character routes. Before a player can list, create, or update their characters, they first exchange owner credentials for a bearer token.
Step 1
Issue a token
Start with POST /api/auth/token. The request body is small on purpose: a username and password are enough to prove identity and receive the token used in the next calls.
What to remember
- Single entrypointAuth currently begins with one endpoint, making the flow easy to learn before moving into the larger Characters surface.
- JSON bodySend credentials in
application/json, not as query params. - Immediate handoffA successful response gives you the token that unlocks the protected owner workflows.
- Use your own accountThe guide shows placeholders only. Students should use the credentials issued for their own account.
Step 2
Send the bearer header
Once the token is issued, include it in the Authorization header with the Bearer scheme. That header is what protected routes inspect before returning player-owned data.
Header pattern
- Exact formatUse
Authorization: Bearer <token>. - Protected todayThe current protected flow centers on the Characters API and its nested equipment, skills, ability score, and spell routes.
- Missing or invalid tokenProtected routes answer with
401 Unauthorizedwhen the token is absent, malformed, or invalid.
Step 3
Continue into protected routes
The educational mental model is simple: credentials in, token out, bearer header on every protected request. For the full route catalog and schemas, keep /docs as the technical reference.
Where Auth leads next
- List characters
GET /api/charactersreturns only the authenticated owner's characters. - Create and updateThe same bearer token is reused for character creation, patches, deletions, and nested character actions.
- Guides vs docsLearn the flow here in
/guides, then inspect complete schemas and status codes in/docs.
Expected return
Request and response shapes
Auth is intentionally small: one request body, one success field, and a short set of error outcomes that are easy to reason about.
Token request body
POST /api/auth/tokenOwner username used to identify which account is asking for a token.
stringPlain-text password checked against the stored owner credentials.
stringExample JSON
Request body{
"username": "<your-username>",
"password": "<your-password>"
}Token response and common errors
200 / 400 / 401 / 500JWT-like bearer token sent in the Authorization header of protected requests.
stringReturned by invalid payload, invalid credentials, or unexpected server failures.
stringExample JSON
200 OK{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3duZXJJZCI6MSwidXNlcm5hbWUiOiJkZW1vIiwiaWF0IjoxNzAwMDAwMDAwLCJleHAiOjE3MDAwMDM2MDB9.signature"
}Authorized follow-up request
GET /api/charactersExample JSON
Request configuration{
"method": "GET",
"path": "/api/characters",
"headers": {
"Authorization": "Bearer <token>"
}
}The Characters API is a more complex workflow. A character can be enriched through multiple calls until it reaches its final state. Creating a character is a longer process that can be done all at once in a single POST request or gradually by choosing character details step by step.
Create flow
Recommended order
This table shows the happy path before the chapter details below. It helps the user understand which request usually comes next during character creation.
| Step | Action | What happens | Request type | Path |
|---|---|---|---|---|
| 1 | Draft | Start the character with the name. | POST | /api/characters |
| 2 | Class | Choose the class with classId. | PATCH | /api/characters/{id} |
| 3 | Specie | Choose the species with speciesId. | PATCH | /api/characters/{id} |
| 4 | Background | Choose the background with backgroundId. | PATCH | /api/characters/{id} |
| 5 | Attributes options | Read the rules before choosing the ability scores. | GET | /api/characters/{id}/ability-score-options |
| 6 | Attributes save | Save the chosen ability scores. | PUT | /api/characters/{id}/ability-scores |
| 7 | Skills | Choose extra skill proficiencies when the class allows it. | PATCH | /api/characters/{id} |
| 8 | Class equipment | Resolve the class equipment package when classEquipmentSelection is pending. | POST | /api/characters/{id}/equipment/class-choice |
| 9 | Background equipment | Resolve the background equipment package when backgroundEquipmentSelection is pending. | POST | /api/characters/{id}/equipment/background-choice |
| 10 | Spell options | Only needed when spellcastingSummary.canCastSpells is true. | GET | /api/characters/{id}/spell-options |
| 11 | Spell selection | Read the current spell selection before saving changes. | GET | /api/characters/{id}/spell-selection |
| 12 | Spell save | Save the chosen spells for the character. | PUT | /api/characters/{id}/spells |
| 13 | Review | Read the final detail response and confirm the current state. | GET | /api/characters/{id} |
Step 1
Draft
Requiriments
- Valid tokenRequired to create a draft character.
- Request type
POST - Minimum bodyA draft can start with only the character name.
Expected return
Response contract
POST /api/characters can create a draft character with only the minimum required information. The API then returns the new character with draft status and missing fields that can be completed later.
Contract fields
POST /api/charactersRequired character name used to create the first draft.
stringNew incomplete characters begin as draft while key setup choices are still missing.
draftShows which important setup fields still need to be completed.
string[]Defaults to level 1 when not provided.
numberExample response
Request bodyExample JSON
POST /api/characters{
"name": "Merien"
}Example response
Draft responseExample JSON
201 Created{
"id": 101,
"name": "Merien",
"status": "draft",
"classId": null,
"speciesId": null,
"backgroundId": null,
"level": 1,
"missingFields": [
"classId",
"speciesId",
"backgroundId"
],
"abilityScores": null,
"abilityModifiers": null
}