See also: Monster API JavaScript Example
Endpoint
http(s)://sw25.nerdsunited.com/api/v1/monster/[command]
Commands
List
Request format: sw25.nerdsunited.com/api/v1/monster/list[?parameter1=option][¶meter2=option][…]
Creates a list of monsters, optionally filtered by parameters.
Parameters
All searches are case insensitive.
sortby: one or more of 'alpha', 'level', 'type'. Separate multiple sort options with the pipe character (|). Multiple sorts are performed in the order provided; for instance, 'sortby=level|alpha' will return a list of monsters sorted first by level, then alphabetically by name within each level.
alpha: either a single letter (alpha=R) or a range (alpha=A-D). Limits searches to monsters whose names start with that single letter or lie within that range (inclusive).
level: either a single number (level=4) or a range (level=1-5). Limits searches to monsters whose level is equal to that single number or lie within that range (inclusive).
type: one and only one of the following strings: 'animal', 'barbarous', 'construct', 'daemon', 'fairy', 'golem', 'humanoid', 'magitech', 'mythical', 'plant', 'undead'. Limits the list to monsters of that type.
habitat: a character string between 3 and 12 characters in length. Returns monsters with the requested string in the habitat field. Will perform a partial search: for instance: 'cemet' will return monsters with both "Cemetery" and "Cemeteries" in their Habitat field.
limit: either a single number (limit=50) or a range (limit=50-100). Allows for pagination or partial searches. 1-based.
name: a character string between 3 and 12 characters in length. Returns monsters with the requested string in the monstername field. Will do a partial search: for instance: 'bolg' will return all monsters with "bolg" in their name, including both "Bolg" and "Loud Bolg Commander".
Example
Request URL: https://sw25.nerdsunited.com/api/v1/monster/list?type=undead&alpha=A
JSON response:
{"monsters": [
{
"monster_id": "3",
"monstername": "Adapsia",
"level": "5",
"monstertype": "Undead",
"habitat": "Forests, Mountain, Wilderness",
"description": "<p>This is an undead person with a corpse-like body. They maintain the same appearance as before they were born and are almost indistinguishable from the living.</p><p>For some reason, their souls were not reincarnated but remained in the corpse. Some resent the world and try to bring misfortune upon it, while others maintain their reason and intelligence and leave their homes to exist alone in remote places. It is said they gather together in some places to form pseudo-families.</p>"
},
{
"monster_id": "19",
"monstername": "Ancient Ghost",
"level": "15",
"monstertype": "Undead",
"habitat": "Various",
"description": "<p>This monster is a powerful Undead that was created with magic from the grudges of the dead from before the Magic Civilization Period. It is extremely rare to encounter them as they are few and buried inside deep dungeons and ruins.</p><p>Like the Ghost, some of them have past knowledge and memories, but their memories are from so long ago that even the source of their hatred is often unclear. Their goals are fuzzy and may appear and disappear from time to time. It is said that if their true desire is identified and fulfilled, their memories will return, and they will disappear.</p>"
}
]}
Get
Returns all data for one monster by monster_id.
Request format: sw25.nerdsunited.com/api/v1/monster/get/[monster_id]
Examples
Request URL (monster with only one section): https://sw25.nerdsunited.com/api/v1/monster/get/426
JSON response:
{
"monster": {
"monster_id": "426",
"monstername": "Zombie Dog",
"level": "1",
"monstertype": "Undead",
"intelligence": "Animal",
"perception": "Magic",
"disposition": "Hostile",
"soulscars": "0",
"language": "None",
"habitat": "Labyrinths, Ruins",
"reputation": "6",
"weakness": "11",
"weakpoint": "HP Recovery (deals damage instead) +3",
"initiative": "8",
"movementspeed": "10 (4 Legs)/-",
"fortitude": "3",
"willpower": "3",
"source": "BM",
"sections": "",
"mainsection": "",
"description": "<p>These wolves and dogs have been animated with mana. They have lost their natural agility and are smaller than Humanoids, so they are not a serious opponent even for novice adventurers.</p>",
"uniqueskills": [
{
"section": "",
"abilities": [
{
"title": "◯Psychic Immunity",
"description": ""
}]}],
"combatstyles": [
{
"style": "Bite",
"accuracy": "3",
"damage": "2d+1",
"evasion": "2",
"defense": "1",
"hp": "14",
"mp": "-"
}],
"loottable": [
{
"roll": "2 - 3",
"loot": "None"
},
{
"roll": "4 - 7",
"loot": "Zombie Eye (30G / Red B)"
},
{
"roll": "8+",
"loot": "Zombie Eye (30G / Red B) x2"
}]}}
Request URL (monster with multiple sections): https://sw25.nerdsunited.com/api/v1/monster/get/65
JSON response:
{
"monster": {
"monster_id": "65",
"monstername": "Bone Knight",
"level": "9",
"monstertype": "Undead",
"intelligence": "Average",
"perception": "Magic",
"disposition": "Hostile",
"soulscars": "0",
"language": "Arcana",
"habitat": "Wilderness, Cemetery",
"reputation": "14",
"weakness": "17",
"weakpoint": "HP Recovery (deals damage instead), +3 points",
"initiative": "16",
"movementspeed": "30 (4 Legs)",
"fortitude": "13",
"willpower": "11",
"source": "CR II p. 374",
"sections": "2 (Rider / Horse)",
"mainsection": "Rider",
"description": "<p>At first glance, this appears to be a mounted knight in armor. However, as the Bone Knight draws near, it's easy to see the skull peering out of the armor, its malice towards the living almost tangible. An old knight from the Magic Civilization age is searching for their lost lord and will let nothing get in their way. Though dead for a while, a Bone Knight's swordsmanship and magical prowess remain as sharp as they were, making the undead knight a truly fearsome foe.</p>",
"uniqueskills": [
{
"section": "All Sections",
"abilities": [
{
"title": "◯Normal Weapon Immunity, ◯Poison Immunity, ◯Disease Immunity, ◯Psychic Type (Weak) Immunity",
"description": ""
},
{
"title": "◯Unstable Healing",
"description": "<p>Healing effects such as Divine Magic and items like Unicorn's Horn will damage Undead instead.</p><p>Magitech, Fairy Magic, Nature Magic, etc. healing has no effect on the Undead.</p><p>Spiritualism Magic and a few other healing effects can restore an Undead's HP.</p>"
}]},
{
"section": "Rider",
"abilities": [
{
"title": "►Spiritualism Magic 8 Level /Magic Power 11 (18)",
"description": ""
},
{
"title": "◯🗨Magic Aptitude",
"description": "<p>They can use the Combat Feats [Targeting], [Magic Convergence], [Magic Control], and [Universal Metamagic].</p>"
},
{
"title": "►Twin Strike & Double Attack",
"description": "<p>It can make two Weapon attacks each round, though each attack requires its own Accuracy check. They may choose to attack different characters with each attack.</p>"
}]},
{
"section": "Horse",
"abilities": [
{
"title": "🗨Power Strike I",
"description": "<p>They can deal an additional 4 damage on their next attack. However, any Evasion Check made by them this turn receives a -2 penalty.</p>"
},
{
"title": "◯Attack Obstacle = +2 • None",
"description": "<p>The enormity of the Horse prevents foes from attacking the Knight.</p><p>The Rider receives a +2 bonus to Evasion checks against melee attacks. When the Horse falls to 0 HP or lower, this effect disappears.</p>"
}]}],
"combatstyles": [
{
"style": "Weapon (Rider)",
"accuracy": "12",
"damage": "2d+13",
"evasion": "11",
"defense": "11",
"hp": "77",
"mp": "58"
},
{
"style": "Hoof (Horse)",
"accuracy": "11",
"damage": "2d+10",
"evasion": "10",
"defense": "8",
"hp": "63",
"mp": "28"
}
],
"loottable": [
{
"roll": "Always",
"loot": "Ghostly Reins (900G/White A)"
},
{
"roll": "2 - 9",
"loot": "None"
},
{
"roll": "10+",
"loot": "Bone Knight Helmet (4,200G/Black White S)"
}]}}
GetAll
Returns all data for all monsters in one huge JSON packet.
Request format: sw25.nerdsunited.com/api/v1/monster/getall
Returns a single array named "allmonsters".