Mice
Data about every mouse in the game. The mice and mouse paths are interchangeable, and any endpoint that takes an :id accepts either the numeric ID or the mouse type (slug).
Get all mice
This endpoint supports filtering, searching, sorting, pagination, and field selection via query parameters — see Search & Querying.
Properties
- Name
idTypeintegerDescriptionMouse ID. - Name
typeTypestringDescriptionMouse type (slug). - Name
nameTypestringDescriptionMouse name. - Name
abbreviated_nameTypestringDescriptionAbbreviated mouse name. - Name
descriptionTypestringDescriptionMouse description. - Name
pointsTypeintegerDescriptionPoints awarded for catching the mouse. - Name
points_formattedTypestringDescriptionPoints, comma-formatted. - Name
goldTypeintegerDescriptionGold awarded for catching the mouse. - Name
gold_formattedTypestringDescriptionGold, comma-formatted. - Name
groupTypestringDescriptionMouse group. - Name
subgroupTypestringDescriptionMouse subgroup. - Name
imagesTypeobjectDescriptionNamethumbnailTypestringDescriptionThumbnail image.Namesilhouette_thumbnailTypestringDescriptionSilhouette thumbnail image.NamemediumTypestringDescriptionMedium image.Namesilhouette_mediumTypestringDescriptionSilhouette medium image.NamelargeTypestringDescriptionLarge image.Namesilhouette_largeTypestringDescriptionSilhouette large image.NamesquareTypestringDescriptionSquare image.Nameis_landscapeTypebooleanDescriptionWhether the image is landscape. - Name
has_weaknessesTypebooleanDescriptionWhether the mouse has any effective weaknesses. - Name
weaknessesTypeobjectDescriptionNameeffectiveTypearrayDescriptionPower types the mouse is weak to. - Name
minlucksTypeobjectDescriptionNamearcaneTypeintegerDescriptionArcane minluck.NamedraconicTypeintegerDescriptionDraconic minluck.NameforgottenTypeintegerDescriptionForgotten minluck.NamehydroTypeintegerDescriptionHydro minluck.NamephysicalTypeintegerDescriptionPhysical minluck.NameshadowTypeintegerDescriptionShadow minluck.NametacticalTypeintegerDescriptionTactical minluck.NamelawTypeintegerDescriptionLaw minluck.NameriftTypeintegerDescriptionRift minluck. - Name
wisdomTypeintegerDescriptionMouse wisdom. - Name
effectivenessesTypeobjectDescriptionNamepowerTypeintegerDescriptionPower effectiveness value.NamearcaneTypeintegerDescriptionArcane effectiveness value.NamedraconicTypeintegerDescriptionDraconic effectiveness value.NameforgottenTypeintegerDescriptionForgotten effectiveness value.NamehydroTypeintegerDescriptionHydro effectiveness value.NamephysicalTypeintegerDescriptionPhysical effectiveness value.NameshadowTypeintegerDescriptionShadow effectiveness value.NametacticalTypeintegerDescriptionTactical effectiveness value.NamelawTypeintegerDescriptionLaw effectiveness value.NameriftTypeintegerDescriptionRift effectiveness value.
Request
GET
https://api.mouse.rip/miceconst mice = await fetch('https://api.mouse.rip/mice')
console.log(mice)
Response
[
{
"id": 958,
"type": "glazed",
"name": "Glazy Mouse",
"abbreviated_name": "Glazy",
"description": "Now here's a guy who knows how to enjoy the holidays! ...",
"points": 50000,
"points_formatted": "50,000",
"gold": 10000,
"gold_formatted": "10,000",
"group": "Event Mice",
"subgroup": "Great Winter Hunt",
"images": {
"thumbnail": "",
"silhouette_thumbnail": "https://www.mousehuntgame.com/images/mice/silhouette_thumb/9b953ab270bc8f746fb4aab19ea30f8e.gif?cv=2",
"medium": "https://www.mousehuntgame.com/images/mice/medium/f0e7f93e6599526a427b418f35064a9b.jpg?cv=2",
"silhouette_medium": "https://www.mousehuntgame.com/images/mice/silhouette_medium/51093497ebab70fd4fc3b20aff68a41d.jpg?cv=2",
"large": "https://www.mousehuntgame.com/images/mice/large/3e34b94eef104d099d0dd3c2166baef7.jpg?cv=2",
"silhouette_large": "https://www.mousehuntgame.com/images/mice/silhouette_large/0dbc988470eb1d6157fe122713daa521.jpg?cv=2",
"square": "https://www.mousehuntgame.com/images/mice/square/baab211c67d0a5e9914c8e832c8ad7a9.jpg?cv=2",
"is_landscape": false
},
"has_weaknesses": true,
"weaknesses": {
"effective": ["Physical", "Shadow", "Tactical", "Arcane", "Forgotten", "Hydro", "Draconic", "Law", "Rift"]
},
"minlucks": {
"arcane": 1, "draconic": 1, "forgotten": 1, "hydro": 1,
"physical": 1, "shadow": 1, "tactical": 1, "law": 1, "rift": 1
},
"wisdom": 3600,
"effectivenesses": {
"power": 2, "arcane": 100, "draconic": 100, "forgotten": 100,
"hydro": 100, "parental": 0, "physical": 100, "shadow": 100,
"tactical": 100, "law": 100, "rift": 100
}
}
]
Get mouse by ID
Replace :id with the mouse type or ID.
Properties
- Name
idTypeintegerDescriptionMouse ID. - Name
typeTypestringDescriptionMouse type (slug). - Name
nameTypestringDescriptionMouse name. - Name
abbreviated_nameTypestringDescriptionAbbreviated mouse name. - Name
descriptionTypestringDescriptionMouse description. - Name
pointsTypeintegerDescriptionPoints awarded for catching the mouse. - Name
points_formattedTypestringDescriptionPoints, comma-formatted. - Name
goldTypeintegerDescriptionGold awarded for catching the mouse. - Name
gold_formattedTypestringDescriptionGold, comma-formatted. - Name
groupTypestringDescriptionMouse group. - Name
subgroupTypestringDescriptionMouse subgroup. - Name
imagesTypeobjectDescriptionNamethumbnailTypestringDescriptionThumbnail image.Namesilhouette_thumbnailTypestringDescriptionSilhouette thumbnail image.NamemediumTypestringDescriptionMedium image.Namesilhouette_mediumTypestringDescriptionSilhouette medium image.NamelargeTypestringDescriptionLarge image.Namesilhouette_largeTypestringDescriptionSilhouette large image.NamesquareTypestringDescriptionSquare image.Nameis_landscapeTypebooleanDescriptionWhether the image is landscape. - Name
has_weaknessesTypebooleanDescriptionWhether the mouse has any effective weaknesses. - Name
weaknessesTypeobjectDescriptionNameeffectiveTypearrayDescriptionPower types the mouse is weak to. - Name
minlucksTypeobjectDescriptionNamearcaneTypeintegerDescriptionArcane minluck.NamedraconicTypeintegerDescriptionDraconic minluck.NameforgottenTypeintegerDescriptionForgotten minluck.NamehydroTypeintegerDescriptionHydro minluck.NamephysicalTypeintegerDescriptionPhysical minluck.NameshadowTypeintegerDescriptionShadow minluck.NametacticalTypeintegerDescriptionTactical minluck.NamelawTypeintegerDescriptionLaw minluck.NameriftTypeintegerDescriptionRift minluck. - Name
wisdomTypeintegerDescriptionMouse wisdom. - Name
effectivenessesTypeobjectDescriptionNamepowerTypeintegerDescriptionPower effectiveness value.NamearcaneTypeintegerDescriptionArcane effectiveness value.NamedraconicTypeintegerDescriptionDraconic effectiveness value.NameforgottenTypeintegerDescriptionForgotten effectiveness value.NamehydroTypeintegerDescriptionHydro effectiveness value.NamephysicalTypeintegerDescriptionPhysical effectiveness value.NameshadowTypeintegerDescriptionShadow effectiveness value.NametacticalTypeintegerDescriptionTactical effectiveness value.NamelawTypeintegerDescriptionLaw effectiveness value.NameriftTypeintegerDescriptionRift effectiveness value.
Request
GET
https://api.mouse.rip/mouse/:id// Can use either type or ID
const mouse = await fetch('https://api.mouse.rip/mouse/glazed')
console.log(mouse)
const mouse = await fetch('https://api.mouse.rip/mouse/958')
console.log(mouse)
Response
{
"id": 958,
"type": "glazed",
"name": "Glazy Mouse",
"abbreviated_name": "Glazy",
"description": "Now here's a guy who knows how to enjoy the holidays! ...",
"points": 50000,
"points_formatted": "50,000",
"gold": 10000,
"gold_formatted": "10,000",
"group": "Event Mice",
"subgroup": "Great Winter Hunt",
"images": { "...": "see /mice above" },
"has_weaknesses": true,
"weaknesses": {
"effective": ["Physical", "Shadow", "Tactical", "Arcane", "Forgotten", "Hydro", "Draconic", "Law", "Rift"]
},
"minlucks": {
"arcane": 1, "draconic": 1, "forgotten": 1, "hydro": 1,
"physical": 1, "shadow": 1, "tactical": 1, "law": 1, "rift": 1
},
"wisdom": 3600,
"effectivenesses": {
"power": 2, "arcane": 100, "draconic": 100, "forgotten": 100,
"hydro": 100, "parental": 0, "physical": 100, "shadow": 100,
"tactical": 100, "law": 100, "rift": 100
}
}
Get mice minlucks
The minimum luck needed to guarantee a catch for each power type. Data source is the Minimum Luck Values spreadsheet.
A raw, unprocessed version keyed by mouse name is available at
/minlucks-raw.
Properties
- Name
idTypeintegerDescriptionMouse ID.
- Name
typeTypestringDescriptionMouse type (slug).
- Name
nameTypestringDescriptionMouse name.
- Name
minlucksTypeobjectDescriptionMinluck per power type (
arcane,draconic,forgotten,hydro,physical,shadow,tactical,law,rift).0means the mouse cannot be caught with that power type.
Request
GET
https://api.mouse.rip/minlucksconst minlucks = await fetch('https://api.mouse.rip/minlucks')
console.log(minlucks)
Response
[
{
"id": 1,
"type": "abominable_snow",
"name": "Abominable Snow Mouse",
"minlucks": {
"arcane": 31, "draconic": 0, "forgotten": 31, "hydro": 31,
"physical": 31, "shadow": 31, "tactical": 31, "law": 31, "rift": 0
}
}
]
Get mice wisdom
Data source is the MH Wisdom Values spreadsheet.
A raw, unprocessed version keyed by mouse name is available at
/wisdom-raw.
Properties
- Name
idTypeintegerDescriptionMouse ID.
- Name
typeTypestringDescriptionMouse type (slug).
- Name
nameTypestringDescriptionMouse name.
- Name
wisdomTypeintegerDescriptionMouse wisdom.
Request
GET
https://api.mouse.rip/wisdomconst wisdom = await fetch('https://api.mouse.rip/wisdom')
console.log(wisdom)
Response
[
{ "id": 1, "type": "abominable_snow", "name": "Abominable Snow Mouse", "wisdom": 1000 },
{ "id": 2, "type": "acolyte", "name": "Acolyte Mouse", "wisdom": 3185 }
]
Get mice effectiveness values
Power-type effectiveness percentages for each mouse. Data source is the Minimum Luck Values spreadsheet.
A raw, unprocessed version keyed by mouse name is available at
/effs-raw.
Properties
- Name
idTypeintegerDescriptionMouse ID.
- Name
typeTypestringDescriptionMouse type (slug).
- Name
nameTypestringDescriptionMouse name.
- Name
effectivenessesTypeobjectDescriptionEffectiveness value per power type (
power,arcane,draconic,forgotten,hydro,parental,physical,shadow,tactical,law,rift).
Request
GET
https://api.mouse.rip/effsconst effs = await fetch('https://api.mouse.rip/effs')
console.log(effs)
Response
[
{
"id": 1,
"type": "abominable_snow",
"name": "Abominable Snow Mouse",
"effectivenesses": {
"power": 1900, "arcane": 100, "draconic": 0, "forgotten": 100,
"hydro": 100, "parental": 0, "physical": 100, "shadow": 100,
"tactical": 100, "law": 100, "rift": 0
}
}
]
Get mice attraction rates
Community-sourced attraction rates (mhct.win) for each mouse, broken down by location and cheese. Rates are percentages.
Properties
- Name
[type]TypeobjectDescriptionKeyed by mouse type. Each value is an object keyed by location.
- Name
[type][location]TypeobjectDescriptionKeyed by location slug. Each value is an object keyed by cheese, with the attraction rate (percent) as the value.
Request
GET
https://api.mouse.rip/mice-attraction-ratesconst rates = await fetch('https://api.mouse.rip/mice-attraction-rates')
console.log(rates)
Response
{
"burglar": {
"bazaar": {
"super_brie_cheese": 20.28,
"brie_cheese": 10.44,
"gilded_cheese": 15.35
},
"kings_arms": {
"gilded_cheese": 24.95,
"super_brie_cheese": 5,
"brie_cheese": 7.46
}
}
}
Get mice thumbnails
A lightweight list of every mouse and its image URLs.
Properties
- Name
idTypeintegerDescriptionMouse ID.
- Name
typeTypestringDescriptionMouse type (slug).
- Name
thumbTypestringDescriptionThumbnail image URL.
- Name
largeTypestringDescriptionLarge image URL.
- Name
squareTypestringDescriptionSquare image URL.
Request
GET
https://api.mouse.rip/mice-thumbnailsconst thumbnails = await fetch('https://api.mouse.rip/mice-thumbnails')
console.log(thumbnails)
Response
[
{
"id": 1,
"type": "abominable_snow",
"thumb": "https://www.mousehuntgame.com/images/mice/thumb/...gif",
"large": "https://www.mousehuntgame.com/images/mice/large/...jpg",
"square": "https://www.mousehuntgame.com/images/mice/square/...jpg"
}
]
Get mice silhouettes
A lightweight list of every mouse with its silhouette image URLs, plus the full-art version for reveals.
Properties
- Name
idTypeintegerDescriptionMouse ID.
- Name
typeTypestringDescriptionMouse type (slug).
- Name
largeTypestringDescriptionLarge silhouette image URL.
- Name
mediumTypestringDescriptionMedium silhouette image URL.
- Name
artTypestringDescriptionFull-art (non-silhouette) image URL.
Request
GET
https://api.mouse.rip/mice-silhouettesconst silhouettes = await fetch('https://api.mouse.rip/mice-silhouettes')
console.log(silhouettes)
Response
[
{
"id": 1,
"type": "abominable_snow",
"large": "https://www.mousehuntgame.com/images/mice/silhouette_large/58a119943b8dc4a132438b8c19f1b83b_voverhall.jpg",
"medium": "https://www.mousehuntgame.com/images/mice/silhouette_medium/0ec05f2f974673f7897ddd9302c4f17e_voverhall.jpg",
"art": "https://www.mousehuntgame.com/images/mice/large/190dfb893cea33795a15054183ad4cc8_voverhall.jpg"
}
]
Get mice groups
Properties
- Name
idTypestringDescriptionMouse group ID.
- Name
nameTypestringDescriptionMouse group name.
Request
GET
https://api.mouse.rip/mice-groupsconst miceGroups = await fetch('https://api.mouse.rip/mice-groups')
console.log(miceGroups)
Response
[
{ "id": "common", "name": "Indigenous Mice" },
{ "id": "dock", "name": "Dock Dwellers" },
{ "id": "mountain", "name": "Mountain Mice" }
]
Get mice regions
Properties
- Name
idTypestringDescriptionMouse region ID.
- Name
nameTypestringDescriptionMouse region name.
Request
GET
https://api.mouse.rip/mice-regionsconst miceRegions = await fetch('https://api.mouse.rip/mice-regions')
console.log(miceRegions)
Response
[
{ "id": "acolyte_realm", "name": "Acolyte Realm" },
{ "id": "balacks_cove", "name": "Balack's Cove" },
{ "id": "bazaar", "name": "Bazaar" }
]
Get CRE mice groups
Groupings of related mice used for catch rate estimation, keyed by group.
Properties
- Name
[group]TypearrayDescriptionKeyed by group slug (e.g.
dragon). An array of the mouse types in the group.
Request
GET
https://api.mouse.rip/cre-mice-groupsconst creMiceGroups = await fetch('https://api.mouse.rip/cre-mice-groups')
console.log(creMiceGroups)
Response
{
"dragon": [
"dragon",
"icewing",
"drag_goon",
...
],
...
}