Adventurers Guild crestAdventurers GuildCampaign Codex

Campaign overview

Adventurers Guild API overview

Choose the learning path that fits your party before opening the wider API realm.

Adventurers Guild API campaign banner

For young adventurers

Start with the illustrated guides

Everything is drawn, organized, and explained for young adventurers who want to understand the Adventurers Guild API before reading the raw contract. Begin with readable chapters for Attributes, Skills, Classes, and Species.

Start with guides

For experienced adventurers

Consult the pure API documentation

If you already know the realm and need exact request shapes, response schemas, endpoints, and contract details, open the technical codex and read the OpenAPI reference directly.

Open API docs

Available quests

Resources currently open in the realm

Each card reads like a compact ledger entry, showing what is already implemented across the growing reference catalogs and authenticated character workflows, plus where to inspect the related routes.

Attributes

attributes

Lookup for the six base attributes used across the project.

Core RPG attributes with descriptions and related skills for each ability score.

Key fields: id, name, shortname, description, skills

GET /api/attributes

Backgrounds

backgrounds

Includes lightweight listing plus detailed background data.

Background catalog with list and detail endpoints for starting identity, proficiencies, and equipment.

Key fields: id, name

GET /api/backgroundsGET /api/backgrounds/{identifier}

Equipment

equipment

Provides lightweight listing plus richer detail payloads with typed equipment-specific fields.

Equipment catalog with list and detail endpoints covering weapons, armor, shields, and generic adventuring gear.

Key fields: category, type, cost, details

GET /api/equipmentGET /api/equipment/{identifier}

Skills

skills

Useful for quick lookups and detailed skill exploration.

Skill collection with attribute mapping, descriptions, usage examples, and common class associations.

Key fields: id, name

GET /api/skillsGET /api/skills/{identifier}

Classes

classes

Supports list and detail access for class-oriented flows.

Playable class data with roles, primary attributes, saving throws, and spellcasting metadata.

Key fields: id, name

GET /api/classesGET /api/classes/{identifier}

Spells

spells

Provides both compact spell listings and rich spell detail.

Spell index with levels and detailed spell information such as school, range, duration, and scaling.

Key fields: id, name, level, levelLabel

GET /api/spellsGET /api/spells/{identifier}

Species

species

Adds ancestry and creature profile data to the current API surface.

Species catalog with list and detail endpoints covering creature type, size, speed, and special traits.

Key fields: id, name, slug, description, creatureType, ...

GET /api/speciesGET /api/species/{identifier}

Auth

auth

Provides token issuance for authenticated requests.

Authentication entrypoint used to issue bearer tokens for protected character workflows.

Key fields: token

POST /api/auth/token

Characters

characters

Introduces authenticated player-oriented workflows with richer character payloads, nested campaign context, pending equipment choices, calculated initiative, passive perception, movement, inventory weight, armor class, derived weapon attacks, hit points, saving throws, skill totals, spellcasting summary, spell slots, selected spell details, and full character equipment tracking.

Protected character management flow with creation, updates, deletion, character equipment add/update/removal, ability score selection, armor class calculation, initiative, passive perception, movement, inventory weight, weapon attack calculation, hit point calculation, saving throw calculation, skill calculation, spellcasting summary, spell slots, spell selection, and enriched responses.

Key fields: status, abilityScores, abilityModifiers, armorClass, weaponAttacks, hitPoints, savingThrows, initiative, passivePerception, movement, inventoryWeight, spellcastingSummary, spellSlots, selectedSpells, currency, skillProficiencies, equipment

GET /api/characters/{id}/equipmentPOST /api/characters/{id}/equipmentPOST /api/characters/{id}/equipment/class-choicePOST /api/characters/{id}/equipment/background-choicePATCH /api/characters/{id}/equipment/{equipmentId}DELETE /api/characters/{id}/equipment/{equipmentId}+11 more endpoints