Monster Hunter World API
App · Gaming · 24 actions
Look up Monster Hunter: World and Iceborne game data through the community-run mhw-db.com API: monsters and their weaknesses, resistances and drops, weapons, armor and armor sets, charms, decorations, skills, items, ailments, locations, motion values, and the event quests running right now. No account or API key required. Every result comes from the Monster Hunter World API created and maintained by LartTyler: documentation at https://docs.mhw-db.com and source code at https://github.com/LartTyler/MHWDB-API. Disclaimer: this is an independent, unofficial integration built by Lodol. It is not officially supported by, endorsed by, affiliated with, or associated with the mhw-db.com project or its maintainers, and neither the project nor its maintainers are responsible for it. Please report any problem with this integration to Lodol rather than to the mhw-db.com project. Monster Hunter: World and all related names and trademarks are the property of Capcom, which is likewise not affiliated with this integration.
Actions
| Action | What it does |
|---|---|
| Get a charm | Get one charm by its id, with every level it can be upgraded to, the skills each level grants, and its crafting materials. |
| Get a decoration | Get one decoration by its id, with its rarity, the slot size it needs, and the skill ranks it grants. |
| Get a location | Get one location by its id, with its zone count and every camp in it. |
| Get a monster | Get one monster by its id: its species and description, the elements it uses, the ailments it inflicts, its elemental weaknesses (with star ratings) and resistances, where it appears, and its full reward table. |
| Get a motion value | Get one motion value by its id: which weapon it belongs to, its damage type, its stun and exhaust potency, and each hit it lands. |
| Get a skill | Get one armor skill by its id, with every rank it has and the stat modifiers each rank applies. |
| Get a weapon | Get one weapon by its id: its displayed and true attack, element damage, sharpness at every handicraft level, decoration slots, elderseal, icon and model images, and the materials to craft or upgrade it. |
| Get an ailment | Get one status ailment by its id, with its description, the actions and items that recover from it, and the items and skills that protect against it. |
| Get an armor piece | Get one armor piece by its id: its defense at base, max, and augmented, its elemental resistances, decoration slots, skills, the set it belongs to, preview images, and what it costs to craft. |
| Get an armor set | Get one armor set by its id, with every piece in the set and the set bonus each tier grants. |
| Get an event | Get one event quest by its id: its description, entry requirements, quest rank, success conditions, start and end times, and where it takes place. |
| Get an item | Get one item by its id, with its description, rarity, carry limit, and Zenny value. |
| Search ailments | Search status ailments such as Blastblight, Bleeding, or Effluvia. |
| Search armor | Search armor pieces by name, the slot they go in, rank, and rarity. |
| Search armor sets | Search armor sets by name and rank. |
| Search charms | Search charms by name. |
| Search decorations | Search decorations (jewels) by name, the slot size they fit in, and rarity. |
| Search events | Search the event quests that are running or scheduled right now, pulled from Capcom's official event pages and refreshed daily. |
| Search items | Search items (monster materials, ores, consumables, and more) by name and rarity. |
| Search locations | Search the game's locations, such as the Ancient Forest or Elder's Recess. |
| Search monsters | Search monsters by name, size (small or large), and species. |
| Search motion values | Search attack motion values: for each move, the damage type, its stun and exhaust potency, and every hit it lands as a percentage of the weapon's raw damage. |
| Search skills | Search armor skills by name. |
| Search weapons | Search weapons by name, weapon type, rarity, and elderseal. |
Get a charm
Get one charm by its id, with every level it can be upgraded to, the skills each level grants, and its crafting materials.
Inputs
- Charm ID
charm_idnumberRequired - The charm's numeric id. Search charms returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
idnumbernametextrankslist
Example output
{
"id": 234,
"name": "Poison Charm",
"ranks": [
{
"crafting": {
"craftable": true,
"materials": [
{
"item": {
"carryLimit": 99,
"description": "Pukei-Pukei material.",
"id": 231,
"name": "Pukei-Pukei Sac",
"rarity": 4,
"value": 200
},
"quantity": 1
}
]
},
"level": 1,
"rarity": 3,
"skills": [
{
"description": "Reduces the duration of poison by 30%.",
"id": 1,
"level": 1,
"modifiers": [],
"skill": 1,
"skillName": "Poison Resistance"
}
]
}
]
}Get a decoration
Get one decoration by its id, with its rarity, the slot size it needs, and the skill ranks it grants.
Inputs
- Decoration ID
decoration_idnumberRequired - The decoration's numeric id. Search decorations returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
idnumbernametextraritynumberskillslistslotnumber
Example output
{
"id": 1,
"name": "Antidote Jewel 1",
"rarity": 5,
"skills": [
{
"description": "Reduces the duration of poison by 30%.",
"id": 1,
"level": 1,
"modifiers": [],
"skill": 1,
"skillName": "Poison Resistance"
}
],
"slot": 1
}Get a location
Get one location by its id, with its zone count and every camp in it.
Inputs
- Location ID
location_idnumberRequired - The location's numeric id. Search locations returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
campslistidnumbernametextzoneCountnumber
Example output
{
"camps": [
{
"id": 1,
"name": "Southwest Camp",
"zone": 1
},
{
"id": 2,
"name": "Northwest Camp",
"zone": 8
}
],
"id": 1,
"name": "Ancient Forest",
"zoneCount": 16
}Get a monster
Get one monster by its id: its species and description, the elements it uses, the ailments it inflicts, its elemental weaknesses (with star ratings) and resistances, where it appears, and its full reward table.
Inputs
- Monster ID
monster_idnumberRequired - The monster's numeric id. Search monsters returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
ailmentslistdescriptiontextelementslistidnumberlocationslistnametextresistanceslistrewardslistspeciestexttypetextweaknesseslist
Example output
{
"ailments": [
{
"description": "A blight caused by the mists in the Rotten Vale.",
"id": 1,
"name": "Effluvia"
}
],
"description": "A grotesque Elder Dragon that inhabits the Rotten Vale.",
"elements": [],
"id": 2,
"locations": [
{
"id": 4,
"name": "Rotten Vale",
"zoneCount": 16
}
],
"name": "Vaal Hazak",
"resistances": [
{
"condition": null,
"element": "water"
}
],
"rewards": [
{
"conditions": [
{
"chance": 15,
"quantity": 1,
"rank": "high",
"subtype": "body",
"type": "carve"
}
],
"id": 1,
"item": {
"carryLimit": 99,
"description": "Vaal Hazak material.",
"id": 67,
"name": "Vaal Hazak Fang",
"rarity": 8,
"value": 1600
}
}
],
"species": "elder dragon",
"type": "large",
"weaknesses": [
{
"condition": null,
"element": "fire",
"stars": 3
}
]
}Get a motion value
Get one motion value by its id: which weapon it belongs to, its damage type, its stun and exhaust potency, and each hit it lands.
Inputs
- Motion value ID
motion_value_idnumberRequired - The motion value's numeric id. Search motion values returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
damageTypetextexhaustnumberhitslistidnumbernametextstunnumberweaponTypetext
Example output
{
"damageType": "blunt",
"exhaust": 40,
"hits": [
15,
76
],
"id": 119,
"name": "Charged Big Bang",
"stun": null,
"weaponType": "hammer"
}Get a skill
Get one armor skill by its id, with every rank it has and the stat modifiers each rank applies.
Inputs
- Skill ID
skill_idnumberRequired - The skill's numeric id. Search skills returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
descriptiontextidnumbernametextrankslist
Example output
{
"description": "Increases attack power.",
"id": 15,
"name": "Attack Boost",
"ranks": [
{
"description": "Attack +3",
"id": 39,
"level": 1,
"modifiers": {
"attack": 3
},
"skill": 15
}
]
}Get a weapon
Get one weapon by its id: its displayed and true attack, element damage, sharpness at every handicraft level, decoration slots, elderseal, icon and model images, and the materials to craft or upgrade it. Bowguns, bows, gunlances, charge blades, switch axes, and insect glaives also carry their own fields, such as ammo capacities or phial type.
Inputs
- Weapon ID
weapon_idnumberRequired - The weapon's numeric id. Search weapons returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
assetsobjectattackobjectcraftingobjectdurabilitylisteldersealtextelementslistidnumbernametextraritynumberslotslisttypetext
Example output
{
"assets": {
"icon": "https://assets.mhw-db.com/weapons/long-sword/icons/iron-grace-3.png",
"image": "https://assets.mhw-db.com/weapons/long-sword/iron-grace-3.png"
},
"attack": {
"display": 462,
"raw": 140
},
"attributes": {
"damageType": "sever"
},
"crafting": {
"branches": [
95
],
"craftable": false,
"craftingMaterials": [],
"previous": 93,
"upgradeMaterials": [
{
"item": {
"carryLimit": 99,
"description": "Ore obtained from mining outcrops.",
"id": 119,
"name": "Carbalite Ore",
"rarity": 6,
"value": 680
},
"quantity": 8
}
]
},
"damageType": "sever",
"durability": [
{
"blue": 30,
"green": 80,
"orange": 50,
"purple": 0,
"red": 90,
"white": 0,
"yellow": 50
}
],
"elderseal": null,
"elements": [
{
"damage": 120,
"hidden": true,
"type": "water"
}
],
"id": 94,
"name": "Iron Grace 3",
"rarity": 5,
"slots": [
{
"rank": 1
}
],
"type": "long-sword"
}Get an ailment
Get one status ailment by its id, with its description, the actions and items that recover from it, and the items and skills that protect against it.
Inputs
- Ailment ID
ailment_idnumberRequired - The ailment's numeric id, for example 2 for Bleeding. Search ailments returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
descriptiontextidnumbernametextprotectionobjectrecoveryobject
Example output
{
"description": "Bleeding causes damage when performing certain actions, such as running.",
"id": 2,
"name": "Bleeding",
"protection": {
"items": [],
"skills": [
{
"description": "Grants protection against bleeding.",
"id": 7,
"name": "Bleeding Resistance"
}
]
},
"recovery": {
"actions": [
"crouch"
],
"items": [
{
"carryLimit": 10,
"description": "Provides a moderate boost to your stamina.",
"id": 11,
"name": "Well-done Steak",
"rarity": 2,
"value": 48
}
]
}
}Get an armor piece
Get one armor piece by its id: its defense at base, max, and augmented, its elemental resistances, decoration slots, skills, the set it belongs to, preview images, and what it costs to craft.
Inputs
- Armor ID
armor_idnumberRequired - The armor piece's numeric id. Search armor returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
armorSetobjectassetsobjectcraftingobjectdefenseobjectidnumbernametextranktextraritynumberresistancesobjectskillslistslotslisttypetext
Example output
{
"armorSet": {
"id": 35,
"name": "Leather Beta",
"pieces": [
159,
160,
161,
162,
163
],
"rank": "high"
},
"assets": {
"imageFemale": "https://assets.mhw-db.com/armor/leather-headgear-beta-female.png",
"imageMale": "https://assets.mhw-db.com/armor/leather-headgear-beta-male.png"
},
"attributes": {},
"crafting": {
"materials": [
{
"item": {
"carryLimit": 99,
"description": "Ore obtained from mining outcrops.",
"id": 119,
"name": "Carbalite Ore",
"rarity": 6,
"value": 680
},
"quantity": 2
}
]
},
"defense": {
"augmented": 70,
"base": 32,
"max": 54
},
"id": 159,
"name": "Leather Headgear Beta",
"rank": "high",
"rarity": 5,
"resistances": {
"dragon": 0,
"fire": 2,
"ice": 0,
"thunder": 0,
"water": 0
},
"skills": [
{
"description": "Extends the time until you run out of stamina.",
"id": 207,
"level": 1,
"modifiers": [],
"skill": 67,
"skillName": "Hunger Resistance"
}
],
"slots": [
{
"rank": 1
}
],
"type": "head"
}Get an armor set
Get one armor set by its id, with every piece in the set and the set bonus each tier grants.
Inputs
- Armor set ID
armor_set_idnumberRequired - The armor set's numeric id. Search armor sets returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
bonusobjectidnumbernametextpieceslistranktext
Example output
{
"bonus": {
"id": 1,
"name": "Anjanath Power",
"ranks": [
{
"pieces": 3,
"skill": {
"description": "Temporarily reduces stamina depletion.",
"id": 311,
"level": 1,
"modifiers": [],
"skill": 112,
"skillName": "Adrenaline"
}
}
]
},
"id": 20,
"name": "Anja",
"pieces": [
{
"armorSet": 20,
"assets": {
"imageFemale": "https://assets.mhw-db.com/armor/anja-helm-female.png",
"imageMale": "https://assets.mhw-db.com/armor/anja-helm-male.png"
},
"attributes": {},
"id": 84,
"name": "Anja Helm",
"rank": "low",
"rarity": 3,
"skills": [
{
"description": "Fire attack +30",
"id": 80,
"level": 1,
"modifiers": {
"damageFire": 30
},
"skill": 26,
"skillName": "Fire Attack"
}
],
"type": "head"
}
],
"rank": "low"
}Get an event
Get one event quest by its id: its description, entry requirements, quest rank, success conditions, start and end times, and where it takes place.
Inputs
- Event ID
event_idnumberRequired - The event's numeric id. Search events returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
endTimestamptextexpansiontextidnumberlocationobjectnametextplatformtextquestRanknumberstartTimestamptexttypetext
Example output
{
"description": "You and your entire party will have to work together.",
"endTimestamp": "2019-07-11T23:59:00+0000",
"exclusive": null,
"expansion": "base",
"id": 1,
"location": {
"camps": [
{
"id": 1,
"name": "Southwest Camp",
"zone": 1
},
{
"id": 2,
"name": "Northwest Camp",
"zone": 8
}
],
"id": 1,
"name": "Ancient Forest",
"zoneCount": 16
},
"name": "A Visitor from Eorzea (Extreme)",
"platform": "console",
"questRank": 9,
"requirements": "HR 50 or higher",
"startTimestamp": "2019-07-05T00:00:00+0000",
"successConditions": "Slay a Behemoth",
"type": "event quest"
}Get an item
Get one item by its id, with its description, rarity, carry limit, and Zenny value.
Inputs
- Item ID
item_idnumberRequired - The item's numeric id. Search items returns ids in 'results'.At least 1.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
carryLimitnumberdescriptiontextidnumbernametextraritynumbervaluenumber
Example output
{
"carryLimit": 10,
"description": "Restores a small amount of health.",
"id": 1,
"name": "Potion",
"rarity": 1,
"value": 8
}Search ailments
Search status ailments such as Blastblight, Bleeding, or Effluvia. Each one comes with the actions and items that clear it and the items and skills that prevent it.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"description": "Bleeding causes damage when performing certain actions, such as running.",
"id": 2,
"name": "Bleeding",
"protection": {
"items": [],
"skills": [
{
"description": "Grants protection against bleeding.",
"id": 7,
"name": "Bleeding Resistance"
}
]
},
"recovery": {
"actions": [
"crouch"
],
"items": [
{
"carryLimit": 10,
"description": "Provides a moderate boost to your stamina.",
"id": 11,
"name": "Well-done Steak",
"rarity": 2,
"value": 48
}
]
}
}
]
}Search armor
Search armor pieces by name, the slot they go in, rank, and rarity. Each piece comes with its defense, elemental resistances, decoration slots, skills, set, and crafting cost.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Armor slot
armor_typetext - Only return pieces worn in this slot. Leave blank for every slot.One of:
head,chest,gloves,waist,legs. - Rank
ranktext - Only return armor of this rank. Master rank gear comes from Iceborne. Leave blank for every rank.One of:
low(Low rank),high(High rank),master(Master rank (Iceborne)). - Rarity
raritynumber - Only return records with exactly this rarity (1 is the lowest; Iceborne gear reaches 12). Leave blank for any rarity.From 1 to 12.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"armorSet": {
"id": 35,
"name": "Leather Beta",
"pieces": [
159,
160,
161,
162,
163
],
"rank": "high"
},
"assets": {
"imageFemale": "https://assets.mhw-db.com/armor/leather-headgear-beta-female.png",
"imageMale": "https://assets.mhw-db.com/armor/leather-headgear-beta-male.png"
},
"attributes": {},
"crafting": {
"materials": [
{
"item": {
"carryLimit": 99,
"description": "Ore obtained from mining outcrops.",
"id": 119,
"name": "Carbalite Ore",
"rarity": 6,
"value": 680
},
"quantity": 2
}
]
},
"defense": {
"augmented": 70,
"base": 32,
"max": 54
},
"id": 159,
"name": "Leather Headgear Beta",
"rank": "high",
"rarity": 5,
"resistances": {
"dragon": 0,
"fire": 2,
"ice": 0,
"thunder": 0,
"water": 0
},
"skills": [
{
"description": "Extends the time until you run out of stamina.",
"id": 207,
"level": 1,
"modifiers": [],
"skill": 67,
"skillName": "Hunger Resistance"
}
],
"slots": [
{
"rank": 1
}
],
"type": "head"
}
]
}Search armor sets
Search armor sets by name and rank. Each set lists every piece in it and its set bonus, including how many pieces each tier of the bonus needs.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Rank
ranktext - Only return sets of this rank. Master rank sets come from Iceborne. Leave blank for every rank.One of:
low(Low rank),high(High rank),master(Master rank (Iceborne)). - Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"bonus": {
"id": 1,
"name": "Anjanath Power",
"ranks": [
{
"pieces": 3,
"skill": {
"description": "Temporarily reduces stamina depletion.",
"id": 311,
"level": 1,
"modifiers": [],
"skill": 112,
"skillName": "Adrenaline"
}
}
]
},
"id": 20,
"name": "Anja",
"pieces": [
{
"armorSet": 20,
"assets": {
"imageFemale": "https://assets.mhw-db.com/armor/anja-helm-female.png",
"imageMale": "https://assets.mhw-db.com/armor/anja-helm-male.png"
},
"attributes": {},
"id": 84,
"name": "Anja Helm",
"rank": "low",
"rarity": 3,
"skills": [
{
"description": "Fire attack +30",
"id": 80,
"level": 1,
"modifiers": {
"damageFire": 30
},
"skill": 26,
"skillName": "Fire Attack"
}
],
"type": "head"
}
],
"rank": "low"
}
]
}Search charms
Search charms by name. Each charm carries every level it can be upgraded to, with the skills that level grants and the materials it costs.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"id": 234,
"name": "Poison Charm",
"ranks": [
{
"crafting": {
"craftable": true,
"materials": [
{
"item": {
"carryLimit": 99,
"description": "Pukei-Pukei material.",
"id": 231,
"name": "Pukei-Pukei Sac",
"rarity": 4,
"value": 200
},
"quantity": 1
}
]
},
"level": 1,
"rarity": 3,
"skills": [
{
"description": "Reduces the duration of poison by 30%.",
"id": 1,
"level": 1,
"modifiers": [],
"skill": 1,
"skillName": "Poison Resistance"
}
]
}
]
}
]
}Search decorations
Search decorations (jewels) by name, the slot size they fit in, and rarity. Each one lists the skill ranks it grants.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Slot size
slotnumber - Only return decorations that fit a slot of this size (1 to 4). Leave blank for any size.From 1 to 4.
- Rarity
raritynumber - Only return records with exactly this rarity (1 is the lowest; Iceborne gear reaches 12). Leave blank for any rarity.From 1 to 12.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"id": 1,
"name": "Antidote Jewel 1",
"rarity": 5,
"skills": [
{
"description": "Reduces the duration of poison by 30%.",
"id": 1,
"level": 1,
"modifiers": [],
"skill": 1,
"skillName": "Poison Resistance"
}
],
"slot": 1
}
]
}Search events
Search the event quests that are running or scheduled right now, pulled from Capcom's official event pages and refreshed daily. Filter by platform, expansion, and quest type.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Platform
platformtext - Only return events running on this platform. An event running on both has one record per platform. Leave blank for both.One of:
pc,console. - Expansion
expansiontext - Only return events that need this expansion. Leave blank for both.One of:
base(Base game),iceborne. - Event type
event_typetext - Only return events of this type. Leave blank for every type.One of:
event quest,challenge quest,kulve taroth siege,safi'jiiva siege. - Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"description": "You and your entire party will have to work together.",
"endTimestamp": "2019-07-11T23:59:00+0000",
"exclusive": null,
"expansion": "base",
"id": 1,
"location": {
"camps": [
{
"id": 1,
"name": "Southwest Camp",
"zone": 1
},
{
"id": 2,
"name": "Northwest Camp",
"zone": 8
}
],
"id": 1,
"name": "Ancient Forest",
"zoneCount": 16
},
"name": "A Visitor from Eorzea (Extreme)",
"platform": "console",
"questRank": 9,
"requirements": "HR 50 or higher",
"startTimestamp": "2019-07-05T00:00:00+0000",
"successConditions": "Slay a Behemoth",
"type": "event quest"
}
]
}Search items
Search items (monster materials, ores, consumables, and more) by name and rarity. Each item comes with its description, carry limit, and Zenny value.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Rarity
raritynumber - Only return records with exactly this rarity (1 is the lowest; Iceborne gear reaches 12). Leave blank for any rarity.From 1 to 12.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"carryLimit": 10,
"description": "Restores a small amount of health.",
"id": 1,
"name": "Potion",
"rarity": 1,
"value": 8
}
]
}Search locations
Search the game's locations, such as the Ancient Forest or Elder's Recess. Each one lists how many zones it has and every camp in it.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"camps": [
{
"id": 1,
"name": "Southwest Camp",
"zone": 1
},
{
"id": 2,
"name": "Northwest Camp",
"zone": 8
}
],
"id": 1,
"name": "Ancient Forest",
"zoneCount": 16
}
]
}Search monsters
Search monsters by name, size (small or large), and species. Each monster comes with its elemental weaknesses and resistances, the ailments it inflicts, where it lives, and everything it can drop.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Size
monster_typetext - Only return small or large monsters. Leave blank for both.One of:
small,large. - Species
speciestext - Only return monsters of this species, for example elder dragon or flying wyvern. Leave blank for every species.One of:
bird wyvern,brute wyvern,elder dragon,fanged beast,fanged wyvern,fish,flying wyvern,herbivore,lynian,neopteron, and 3 more. - Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"ailments": [
{
"description": "A blight caused by the mists in the Rotten Vale.",
"id": 1,
"name": "Effluvia"
}
],
"description": "A grotesque Elder Dragon that inhabits the Rotten Vale.",
"elements": [],
"id": 2,
"locations": [
{
"id": 4,
"name": "Rotten Vale",
"zoneCount": 16
}
],
"name": "Vaal Hazak",
"resistances": [
{
"condition": null,
"element": "water"
}
],
"rewards": [
{
"conditions": [
{
"chance": 15,
"quantity": 1,
"rank": "high",
"subtype": "body",
"type": "carve"
}
],
"id": 1,
"item": {
"carryLimit": 99,
"description": "Vaal Hazak material.",
"id": 67,
"name": "Vaal Hazak Fang",
"rarity": 8,
"value": 1600
}
}
],
"species": "elder dragon",
"type": "large",
"weaknesses": [
{
"condition": null,
"element": "fire",
"stars": 3
}
]
}
]
}Search motion values
Search attack motion values: for each move, the damage type, its stun and exhaust potency, and every hit it lands as a percentage of the weapon's raw damage. Pick a weapon type to get just that weapon's moves.
Inputs
- Weapon type
weapon_typetext - Only return moves for this weapon. Leave blank for every weapon.One of:
great-sword(Great Sword),long-sword(Long Sword),sword-and-shield(Sword and Shield),dual-blades(Dual Blades),hammer,hunting-horn(Hunting Horn),lance,gunlance,switch-axe(Switch Axe),charge-blade(Charge Blade), and 4 more. - Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"damageType": "blunt",
"exhaust": 40,
"hits": [
15,
76
],
"id": 119,
"name": "Charged Big Bang",
"stun": null,
"weaponType": "hammer"
}
]
}Search skills
Search armor skills by name. Each skill carries every rank it has, with what that rank does and the stat modifiers it applies.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"description": "Increases attack power.",
"id": 15,
"name": "Attack Boost",
"ranks": [
{
"description": "Attack +3",
"id": 39,
"level": 1,
"modifiers": {
"attack": 3
},
"skill": 15
}
]
}
]
}Search weapons
Search weapons by name, weapon type, rarity, and elderseal. Each weapon comes with its attack values, elements, sharpness by handicraft level, decoration slots, and where it sits in its upgrade tree.
Inputs
- Name contains
nametext - Only return records whose name contains this text, for example 'rath' or 'Nergigante'. Leave blank to return everything.
- Weapon type
weapon_typetext - Only return weapons of this type. Leave blank for every type.One of:
great-sword(Great Sword),long-sword(Long Sword),sword-and-shield(Sword and Shield),dual-blades(Dual Blades),hammer,hunting-horn(Hunting Horn),lance,gunlance,switch-axe(Switch Axe),charge-blade(Charge Blade), and 4 more. - Rarity
raritynumber - Only return records with exactly this rarity (1 is the lowest; Iceborne gear reaches 12). Leave blank for any rarity.From 1 to 12.
- Elderseal
eldersealtext - Only return weapons with this elderseal strength. Leave blank for every weapon, including those with no elderseal.One of:
low,average,high. - Advanced filter
querytext - Optional filter for anything the fields above don't cover, written as a JSON query document, for example {"defense.base": {"$gte": 50}} or {"crafting.branches": {"$size": 0}}. Nested fields use dot notation, and it can be combined with the simple filters above (this one wins if both set the same field). See https://docs.mhw-db.com/#searching-the-api.
- Fields to return
fieldstext - Comma-separated list of fields to keep in each record, for example 'id, name, rarity'. Nested fields use dot notation ('crafting.branches'). Leave blank to get the full records, which for armor, weapons, and monsters are large.
- Limit
limitnumber - How many records to return. Defaults to 25. The API answers with every match at once, so this trims the list afterwards; 'count' on the result always reports the full number of matches.From 1 to 500. Default:
25. - Offset
offsetnumber - How many matches to skip before returning results, for paging through a large list. Defaults to 0, which starts at the first match.At least 0. Default:
0. - Language
languagetext - Which language to return names and descriptions in. Defaults to English. Translations are contributed by hand, so an untranslated field comes back empty.One of:
en(English),fr(French),de(German),zh(Chinese (simplified)),zh-Hant(Chinese (traditional)). Default:en.
Outputs
countnumber- How many records matched the search in total
resultslist- The matching records, trimmed to the limit and offset
Example output
{
"count": 1,
"results": [
{
"assets": {
"icon": "https://assets.mhw-db.com/weapons/long-sword/icons/iron-grace-3.png",
"image": "https://assets.mhw-db.com/weapons/long-sword/iron-grace-3.png"
},
"attack": {
"display": 462,
"raw": 140
},
"attributes": {
"damageType": "sever"
},
"crafting": {
"branches": [
95
],
"craftable": false,
"craftingMaterials": [],
"previous": 93,
"upgradeMaterials": [
{
"item": {
"carryLimit": 99,
"description": "Ore obtained from mining outcrops.",
"id": 119,
"name": "Carbalite Ore",
"rarity": 6,
"value": 680
},
"quantity": 8
}
]
},
"damageType": "sever",
"durability": [
{
"blue": 30,
"green": 80,
"orange": 50,
"purple": 0,
"red": 90,
"white": 0,
"yellow": 50
}
],
"elderseal": null,
"elements": [
{
"damage": 120,
"hidden": true,
"type": "water"
}
],
"id": 94,
"name": "Iron Grace 3",
"rarity": 5,
"slots": [
{
"rank": 1
}
],
"type": "long-sword"
}
]
}