--- title: "Search item database" method: POST path: "/item/search" tags: ["item"] --- # Search item database `POST /item/search` This endpoint is cached for 1 hour in the SHARED cache source. See [Caching](/welcome#caching). This endpoint belongs to the ITEMS rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits). Filters can be empty and do not always need to be present in the payload. To understand the endpoint better, try the official Wynncraft item guide while monitoring the network tab in your browser devtools. `fullResult` bypasses pagination and returns the `results` object for all objects at once. This endpoint uses the generic pagination response format. ## Query parameters - `page` integer - `fullResult` '' ## Request body - ItemSearchRequest - `query` string, nullable - `type` union - 'weapon' | 'armour' | 'accessory' | 'charm' | 'tome' | 'tool' | 'material' | 'ingredient' - ItemTypeName[] - `tier` union - 'rare' | 'unique' | 'normal' | 'legendary' | 'mythic' | 'fabled' | 'TIER3' | 'TIER2' | 'TIER1' | 'TIER0' - ItemTierName[] - `attackSpeed` union - 'slow' | 'fast' | 'superSlow' | 'normal' | 'verySlow' | 'veryFast' | 'superFast' - ItemAttackSpeedName[] - `levelRange` union - integer - integer[] - `professions` union - 'farming' | 'fishing' | 'mining' | 'woodcutting' - ItemGatheringName[] - `identifications` union - 'baseDamage' | 'baseEarthDamage' | 'baseThunderDamage' | 'baseWaterDamage' | 'baseFireDamage' | 'baseAirDamage' | 'strength' | 'dexterity' | 'intelligence' | 'defence' | 'agility' | 'healthRegenRaw' | 'rawSpellDamage' | 'rawMainAttackDamage' | 'elementalDefence' | 'rawDefence' | 'walkSpeed' | 'airDamage' | 'thunderDamage' | 'spellDamage' | 'raw1stSpellCost' | 'knockback' | 'fireDamage' | 'mainAttackDamage' | 'lifeSteal' | 'manaSteal' | 'weakenEnemy' | 'waterDefence' | 'airDefence' | 'rawDexterity' | 'manaRegen' | 'combatExperience' | 'slowEnemy' | 'waterDamage' | 'earthDefence' | 'exploding' | 'thunderDefence' | 'rawAgility' | 'reflection' | 'earthDamage' | 'healthRegen' | 'rawHealth' | 'damage' | 'elementalDamage' | 'rawAttackSpeed' | 'sprint' | 'raw4thSpellCost' | 'rawIntelligence' | 'rawAirDamage' | 'jumpHeight' | 'rawStrength' | 'rawElementalSpellDamage' | 'thorns' | 'fireDefence' | 'raw3rdSpellCost' | 'sprintRegen' | 'poison' | 'elementalSpellDamage' | 'rawThunderMainAttackDamage' | 'rawEarthMainAttackDamage' | 'fireSpellDamage' | 'stealing' | 'rawThunderDamage' | 'mainAttackRange' | 'raw2ndSpellCost' | '1stSpellCost' | '3rdSpellCost' | 'rawFireDamage' | 'lootBonus' | 'fireMainAttackDamage' | 'rawAirMainAttackDamage' | 'rawDamage' | '4thSpellCost' | 'rawElementalDamage' | 'elementalMainAttackDamage' | 'earthMainAttackDamage' | 'thunderMainAttackDamage' | 'rawMaxMana' | 'rawAirSpellDamage' | '2ndSpellCost' | 'rawEarthDamage' | 'earthSpellDamage' | 'waterSpellDamage' | 'rawFireSpellDamage' | 'criticalDamageBonus' | 'airSpellDamage' | 'rawThunderSpellDamage' | 'rawWaterSpellDamage' | 'rawFireMainAttackDamage' | 'neutralSpellDamage' | 'neutralDamage' | 'rawNeutralMainAttackDamage' | 'thunderSpellDamage' | 'rawEarthSpellDamage' | 'rawNeutralDamage' | 'rawWaterDamage' | 'healingEfficiency' | 'rawElementalMainAttackDamage' | 'airMainAttackDamage' | 'rawNeutralSpellDamage' | 'baseHealth' | 'baseEarthDefence' | 'baseFireDefence' | 'baseThunderDefence' | 'baseWaterDefence' | 'baseAirDefence' | 'neutralMainAttackDamage' | 'leveledXpBonus' | 'damageFromMobs' | 'leveledLootBonus' | 'gatheringExperience' | 'gatherXpBonus' | 'gatherSpeed' | 'lootQuality' | 'rawWaterMainAttackDamage' | 'AGILITYBONUS' | 'STRENGTHBONUS' - ItemIdentificationKey[] - `majorIds` union - 'evershot' | 'forestSBlessing' | 'fallout' | 'twistingThreads' | 'pioneerSEcho' | 'altruism' | 'freerunner' | 'vedette' | 'realityRevision' | 'seekingModule' | 'fission' | 'freneticSpirit' | 'netShot' | 'deathSentence' | 'regicide' | 'selfSufficient' | 'napalm' | 'riverofSouls' | 'comboStomp' | 'gunkShot' | 'heartbeat' | 'methodical' | 'fantheHammer' | 'wormhole' | 'punishment' | 'grandInfluence' | 'cherryBombs' | 'greed' | 'windsurf' | 'hurricaneSEye' | 'sorcery' | 'rovingAssassin' | 'transcendence' | 'efflorescence' | 'spaceGlide' | 'heatShimmer' | 'soulEater' | 'juggle' | 'flurryofBlows' | 'incisionElegy' | 'lightningCrash' | 'livingMuseum' | 'manicEdge' | 'enlightenment' | 'ignitionWhirlwind' | 'lifestream' | 'peacefulEffigy' | 'stringsofFate' | 'ergosphere' | 'deadWeight' | 'sublimation' | 'furiousEffigy' | 'faustianGambit' | 'totemicFuse' | 'geocentrism' | 'gruesomeKnots' | 'starcrossed' | 'chaosReach' | 'flainRemnants' | 'litFuse' | 'rally' | 'hellfire' | 'paragon' | 'divineHonor' | 'trollBarge' | 'tidalDrift' | 'guardian' | 'lastResort' | 'saviourSSacrifice' | 'scarceComfort' | 'vitriol' | 'tackle' | 'divineRight' | 'slowBoil' | 'stagnantAir' | 'oldSpark' | 'oneselfUntoAll' | 'temblor' | 'overwhelm' | 'meteorCrash' | 'earthenSplinter' | 'entropy' | 'fixate' | 'lustrate' | 'inversion' | 'cosmicCapture' | 'orbitalChain' | 'perfectRecall' | 'gravityWell' | 'displace' | 'lockdown' | 'plague' | 'solarWind' | 'wavebreak' | '֎' | 'gentleGlow' | 'blindingLights' | 'oneiro' | 'dauntlessInferno' | 'fissure' | 'flashfreeze' | 'perilousFlare' | 'explosiveImpact' | 'escapeRoute' | 'lightweight' | 'pirouette' | 'lunge' | 'taunt' | 'desperateMeasures' | 'rockShield' | 'cannulate' | 'snowySteps' | 'phoenixBorn' | 'superconductor' | 'magnet' | 'alterEgo' | 'mangle' | 'intangible' | 'iceStorm' | 'pounce' | 'hawkeye' | 'orbwalk' | 'burntShadows' | 'frightorFlight' | 'festiveSpirit' | 'sunEater' | 'recklessAbandon' | 'expunge' | 'brachiate' | 'rustedIchor' | 'findThyself' | 'madness' | 'clamber' | 'splitSecond' | 'spectralMemory' | 'insoluble' | 'boundbyBlood' | 'mobMentality' | 'lasso' | 'coagulate' | 'flightBurst' | 'culicidaeCreed' | 'powerFist' | 'brutalBlow' - ItemMajorIdKey[] ## Response `200` Paginated search results. - PaginatedItemResponse - `controller` PaginationController, required - `count` integer, required - `current_count` integer, required - `pages` integer, required - `prev` integer, nullable, required - `current` integer, required - `next` integer, nullable, required - `results` Item[], required - `displayName` string, required - `internalName` string, required - `type` 'weapon' | 'armour' | 'accessory' | 'charm' | 'tome' | 'tool' | 'material' | 'ingredient', required - `subType` 'bow' | 'dagger' | 'relik' | 'spear' | 'wand' | 'boots' | 'chestplate' | 'helmet' | 'leggings' | 'bracelet' | 'necklace' | 'ring' | 'guildTome' | 'armourTome' | 'expertiseTome' | 'marathonTome' | 'mysticismTome' | 'lootrunTome' | 'weaponTome' | 'axe' | 'rod' | 'pickaxe' | 'scythe' | 'farming' | 'fishing' | 'mining' | 'woodcutting', required - `icon` ItemIcon, required - `value` AbilityIconValue, required - `id` string, required - `name` string, required - `customModelData` AbilityIconValueCustomModelData, required - `rangeDispatch` integer[], required - `format` string, required - `emblem` 'diamond5' | 'diamond_5' | 'diamond1' | 'diamond_1' | 'diamond4' | 'diamond_4' | 'diamond6' | 'diamond_6' | 'diamond3' | 'diamond_3' | 'diamond2' | 'diamond_2' | 'shield5' | 'shield_5' | 'shield1' | 'shield_1' | 'shield4' | 'shield_4' | 'shield6' | 'shield_6' | 'shield3' | 'shield_3' | 'shield2' | 'shield_2' | 'shield' | 'sticker5' | 'sticker_5' | 'sticker1' | 'sticker_1' | 'sticker4' | 'sticker_4' | 'sticker6' | 'sticker_6' | 'sticker3' | 'sticker_3' | 'sticker2' | 'sticker_2' | 'square5' | 'square_5' | 'square4' | 'square_4' | 'square6' | 'square_6' | 'square', required - `tier` 'rare' | 'unique' | 'normal' | 'legendary' | 'mythic' | 'fabled' | 'TIER3' | 'TIER2' | 'TIER1' | 'TIER0', required - `attackSpeed` 'slow' | 'fast' | 'superSlow' | 'normal' | 'verySlow' | 'veryFast' | 'superFast' - `averageDps` number, double - `restriction` string - `dropRestriction` string - `gathering` 'farming' | 'fishing' | 'mining' | 'woodcutting' - `set` 'boundless' | 'corrupted' | 'firemoss' | 'bony' | 'spore' | 'petal' | 'scrap' | 'beachside' | 'pigman' | 'toxic' | 'regal' | 'vexing' | 'voidglass' | 'cosmicFoundations' | 'snail' | 'thanosLegionnaire' | 'uth' | 'cosmic' | 'leaf' | 'tribal' | 'saint's' | 'visceral' | 'ascension' | 'ultramarine' | 'taigaElk' | 'clock' | 'nii' | 'moirai' | 'bleeding' | 'liffmail' | 'elf' | 'slime' | 'goblin' | 'ghostly' | 'horse' | 'snow' | 'skien's' | 'thunderRelic' | 'morph' | 'black' | 'earthRelic' | 'waterRelic' | 'relic' | 'outlaw' | 'silverfish' | 'nether' | 'fireRelic' | 'airRelic' | 'adventurer' | 'darkened' | 'bovine' | 'bear' | 'kaerynn' | 'villager' | 'spider' | 'conqueredSkies' | 'synchCore' | 'flashfire' | 'jester' | 'forgottenChronicles' | 'wynnterfest2016' | 'bandit's' | 'desert' | 'blackCatalyst' | 'constellation' | 'hallowynn2016' - `elements` string[] - `requirements` ItemRequirements - `level` integer - `classRequirement` string - `strength` integer - `dexterity` integer - `intelligence` integer - `defence` integer - `agility` integer - `majorIds` object - `powderSlots` integer - `lore` string - `identifications` object - `base` object ## Other responses - `400` — Invalid request payload. - `404` — No items matched the request. --- [API](https://skmtc.dev/wynncraft/apis/modules.md) · [All operations](https://skmtc.dev/wynncraft/apis/modules/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wynncraft/modules/revisions/6c6214729eae/schema)