Items

Data about every item in the game. Any endpoint that takes an :id accepts either the numeric ID or the item type (slug).

Get all items

GEThttps://api.mouse.rip/items

This endpoint supports filtering, searching, sorting, pagination, and field selection via query parameters — see Search & Querying.

Properties

Name
id
Type
integer
Description
Item ID.
Name
type
Type
string
Description
Item type (slug).
Name
name
Type
string
Description
Item name.
Name
description
Type
string
Description
Item description.
Name
classification
Type
string
Description
Item classification.
Name
tags
Type
array
Description
Item tags.
Name
environment
Type
array
Description
Environments the item is available in.
Name
images
Type
object
Description
Item image URLs.
Name
is_limited_edition
Type
boolean
Description
Whether the item is limited edition.
Name
is_givable
Type
boolean
Description
Whether the item can be given to other hunters.
Name
is_tradable
Type
boolean
Description
Whether the item can be traded.
Name
is_convertible
Type
boolean
Description
Whether the item can be opened/converted.
Name
is_smashable
Type
boolean
Description
Whether the item can be smashed at the Catalog.
Name
is_potion
Type
boolean
Description
Whether the item is a potion.
Name
is_skin
Type
boolean
Description
Whether the item is a trap skin.
Name
is_charm
Type
boolean
Description
Whether the item is a charm.
Name
is_quantity_limited
Type
boolean
Description
Whether the item is quantity limited.
Name
has_stats
Type
object
Description
Item stats (power, luck, etc.) when applicable.
Name
quantity_limit
Type
integer
Description
Item quantity limit.

Request

GET

https://api.mouse.rip/items

const items = await fetch('https://api.mouse.rip/items')
console.log(items)

Response

[
  {
    "id": 1168,
    "type": "hot_tub_weapon",
    "name": "Mouse Hot Tub",
    "description": "Instead of harming a mouse, give it a soothing place to relax ...",
    "classification": "weapon",
    "tags": ["physical", "weapon"],
    "environment": ["cape_clawed", "derr_dunes", "dracano"],
    "images": {
      "thumbnail": "https://www.mousehuntgame.com/images/items/weapons/a84f9ea42272cb2f19592f90fbf199c8.jpg?cv=2",
      "large": "https://www.mousehuntgame.com/images/items/weapons/trap_small/f1cbf7275abfcead8bab92d49b21a592.png?cv=2",
      "gray": "https://www.mousehuntgame.com/images/items/weapons/gray/6bd5591a5f54daec926239a131374496.jpg?cv=2",
      "transparent": "",
      "transparent_large": "",
      "best": "https://www.mousehuntgame.com/images/items/weapons/trap_small/f1cbf7275abfcead8bab92d49b21a592.png?cv=2"
    },
    "is_limited_edition": false,
    "is_givable": false,
    "is_tradable": false,
    "is_convertible": false,
    "is_smashable": false,
    "is_potion": false,
    "is_skin": false,
    "is_charm": false,
    "is_quantity_limited": true,
    "has_stats": {
      "power_type": "physical",
      "power": 70,
      "power_bonus_formatted": "3%",
      "attraction_bonus_formatted": "35%",
      "luck": 2,
      "cheese_effect": "No Effect",
      "min_title": "novice"
    },
    "quantity_limit": 1
  }
]

Get item by ID

GEThttps://api.mouse.rip/items/:id

Replace :id with the item type or ID.

Properties

Name
id
Type
integer
Description
Item ID.
Name
type
Type
string
Description
Item type (slug).
Name
name
Type
string
Description
Item name.
Name
description
Type
string
Description
Item description.
Name
classification
Type
string
Description
Item classification.
Name
tags
Type
array
Description
Item tags.
Name
environment
Type
array
Description
Environments the item is available in.
Name
images
Type
object
Description
Item image URLs.
Name
is_limited_edition
Type
boolean
Description
Whether the item is limited edition.
Name
is_givable
Type
boolean
Description
Whether the item can be given to other hunters.
Name
is_tradable
Type
boolean
Description
Whether the item can be traded.
Name
is_convertible
Type
boolean
Description
Whether the item can be opened/converted.
Name
is_smashable
Type
boolean
Description
Whether the item can be smashed at the Catalog.
Name
is_potion
Type
boolean
Description
Whether the item is a potion.
Name
is_skin
Type
boolean
Description
Whether the item is a trap skin.
Name
is_charm
Type
boolean
Description
Whether the item is a charm.
Name
is_quantity_limited
Type
boolean
Description
Whether the item is quantity limited.
Name
has_stats
Type
object
Description
Item stats (power, luck, etc.) when applicable.
Name
quantity_limit
Type
integer
Description
Item quantity limit.

Request

GET

https://api.mouse.rip/items/:id

// Can use either type or ID
const item = await fetch('https://api.mouse.rip/items/hot_tub_weapon')
console.log(item)

const item = await fetch('https://api.mouse.rip/items/1168')
console.log(item)

Response

{
  "id": 1168,
  "type": "hot_tub_weapon",
  "name": "Mouse Hot Tub",
  "description": "Instead of harming a mouse, give it a soothing place to relax ...",
  "classification": "weapon",
  "tags": ["physical", "weapon"],
  "environment": ["cape_clawed", "derr_dunes", "dracano"],
  "images": { "...": "see /items above" },
  "is_tradable": false,
  "is_convertible": false,
  "has_stats": {
    "power_type": "physical",
    "power": 70,
    "luck": 2,
    "cheese_effect": "No Effect",
    "min_title": "novice"
  },
  "quantity_limit": 1
}

Get slim items

GEThttps://api.mouse.rip/items-slim

A trimmed-down version of every item with just the identifying fields and images, for when the full /items payload is more than you need.

Properties

Name
id
Type
integer
Description
Item ID.
Name
type
Type
string
Description
Item type (slug).
Name
name
Type
string
Description
Item name.
Name
classification
Type
string
Description
Item classification.
Name
tags
Type
array
Description
Item tags.
Name
images
Type
object
Description
Image URLs (thumbnail, best, upscaled).

Request

GET

https://api.mouse.rip/items-slim

const items = await fetch('https://api.mouse.rip/items-slim')
console.log(items)

Response

[
  {
    "id": 1,
    "type": "balack_lantern_map_piece",
    "name": "Balack's Lantern",
    "classification": "map_piece",
    "tags": ["map_piece"],
    "images": {
      "thumbnail": "https://www.mousehuntgame.com/images/items/maps/69c29dfc90eea078ed36a05371499af3.jpg",
      "best": "https://www.mousehuntgame.com/images/items/maps/69c29dfc90eea078ed36a05371499af3.jpg",
      "upscaled": "https://i.mouse.rip/upscaled/69c29dfc90eea078ed36a05371499af3.png"
    }
  }
]

Get tradable items

GEThttps://api.mouse.rip/items-tradable

A lightweight list of every item that can be traded.

Properties

Name
id
Type
integer
Description
Item ID.
Name
type
Type
string
Description
Item type (slug).
Name
name
Type
string
Description
Item name.
Name
image
Type
string
Description
Item image URL.
Name
truncated_name
Type
string
Description
Truncated item name.

Request

GET

https://api.mouse.rip/items-tradable

const tradableItems = await fetch('https://api.mouse.rip/items-tradable')
console.log(tradableItems)

Response

[
  {
    "id": 103,
    "type": "maki_cheese",
    "name": "Maki Cheese",
    "image": "https://www.mousehuntgame.com/images/items/bait/df0071729e6a9f91360c124a40eae8ec.jpg",
    "truncated_name": "Maki Cheese"
  }
]

Get item thumbnails

GEThttps://api.mouse.rip/item-thumbnails

A lightweight list of every item and its image URLs.

Properties

Name
id
Type
integer
Description
Item ID.
Name
type
Type
string
Description
Item type (slug).
Name
image
Type
string
Description
Item image URL.
Name
thumb
Type
string
Description
Thumbnail image URL.

Request

GET

https://api.mouse.rip/item-thumbnails

const thumbnails = await fetch('https://api.mouse.rip/item-thumbnails')
console.log(thumbnails)

Response

[
  {
    "id": 1,
    "type": "balack_lantern_map_piece",
    "image": "https://www.mousehuntgame.com/images/items/maps/69c29dfc90eea078ed36a05371499af3.jpg",
    "thumb": "https://www.mousehuntgame.com/images/items/maps/69c29dfc90eea078ed36a05371499af3.jpg"
  }
]

Get item names to IDs

GEThttps://api.mouse.rip/items-names-to-ids

A lookup map of item display name to item ID. Handy for resolving names from the game UI to IDs.

Properties

Name
[name]
Type
integer
Description
Keyed by item display name, with the item ID as the value.

Request

GET

https://api.mouse.rip/items-names-to-ids

const namesToIds = await fetch('https://api.mouse.rip/items-names-to-ids')
console.log(namesToIds)

Response

{
  "Calm Clearing Map Piece": 16,
  "Fire Salt": 196,
  "Ancient Spear": 170,
  "Power Charm": 351
}