Relic Hunter

Get Relic Hunter location

GEThttps://api.mouse.rip/relic-hunter

The Relic Hunter's current location, from MHCT. If MHCT reports a location this API doesn't know, or can't be reached, the response is { "id": "unknown", "name": "Unknown", "last_seen": … }.

Properties

Name
id
Type
string
Description
The environment ID.
Name
name
Type
string
Description
The environment name.
Name
article
Type
string
Description
The environment name with article.
Name
image
Type
string
Description
The environment image.
Name
headerImage
Type
string
Description
The environment header image.
Name
region
Type
string
Description
The environment region.
Name
order
Type
integer
Description
The environment order.
Name
title
Type
string
Description
The title needed to access the environment.
Name
last_seen
Type
string
Description
When MHCT last saw the Relic Hunter there, as an ISO 8601 date, or null.

Request

GET

https://api.mouse.rip/relic-hunter

const response = await fetch('https://api.mouse.rip/relic-hunter')

Response

{
  "id": "meadow",
  "name": "Meadow",
  "article": "the Meadow",
  "image": "https://www.mousehuntgame.com/images/environments/a441eb078698da69ef2765983f4b5912.jpg",
  "headerImage": "https://www.mousehuntgame.com/images/environments/6ef3ffe2f90a79250807b46105e77b68.jpg",
  "region": "gnawnia",
  "order": 10,
  "title": "novice",
  "last_seen": "2026-10-10T19:45:12.000Z"
}

Get Relic Hunter history

GEThttps://api.mouse.rip/relic-hunter/history

When the Relic Hunter was last seen in each location, most recent first. Sightings are recorded at least every two hours; locations it hasn't been seen in since recording started aren't listed.

Properties

Name
id
Type
string
Description
The location slug.
Name
name
Type
string
Description
The location name.
Name
environment_id
Type
integer
Description
The game's numeric environment ID.
Name
last_seen
Type
string
Description
When the Relic Hunter was last seen there, as an ISO 8601 date.

Request

GET

https://api.mouse.rip/relic-hunter/history

const response = await fetch('https://api.mouse.rip/relic-hunter/history')

Response

[
  {
    "id": "meadow",
    "name": "Meadow",
    "environment_id": 18,
    "last_seen": "2026-10-10T19:45:12.000Z"
  },
  {
    "id": "harbour",
    "name": "Harbour",
    "environment_id": 1,
    "last_seen": "2026-10-08T03:12:40.000Z"
  }
]

Get when the Relic Hunter was last in a location

GEThttps://api.mouse.rip/relic-hunter/history/:id

The last sighting in one location. Replace :id with the location's slug, numeric environment ID, or name. A location it hasn't been seen in since recording started has last_seen: null.

Properties

Name
id
Type
string
Description
The location slug.
Name
name
Type
string
Description
The location name.
Name
environment_id
Type
integer
Description
The game's numeric environment ID.
Name
last_seen
Type
string
Description
When the Relic Hunter was last seen there, as an ISO 8601 date, or null if it hasn't been seen there since recording started.

Request

GET

https://api.mouse.rip/relic-hunter/history/meadow

const response = await fetch('https://api.mouse.rip/relic-hunter/history/meadow')

Response

{
  "id": "meadow",
  "name": "Meadow",
  "environment_id": 18,
  "last_seen": "2026-10-10T19:45:12.000Z"
}

Get Relic Hunter Hints

GEThttps://api.mouse.rip/relic-hunter-hints

Hints for each Relic Hunter location, keyed by location ID.

Properties

Name
location
Type
string
Description
The location ID.
Name
hints
Type
array of values
Description
The array of hints for the location.

Request

GET

https://api.mouse.rip/relic-hunter-hints

const response = await fetch('https://api.mouse.rip/relic-hunter-hints')

Response

{
  "acolyte_realm": [
    "Standing on the other side of a green and purple portal.",
    "Inside an elaborate one-way trap designed by Plankrun.",
    ...
  ],
  "balacks_cove": [
    "Roaming amongst the most powerful of Lich mice.",
    "Lurking in a damp and darkened grotto."
  ],
  "bazaar": [
    "Searching for the best deals in the Burroughs.",
    "Ducking between stalls and tents and loud merchants.",
    ...
  ],
  ...
}