haunt.gg | Lookup User

Resolve a haunt.gg user by their username, numeric uid, or internal id. By default the response is a lean basic payload; opt into additional data (full profile, badges, links, projects, and more) with per-section include flags so you only ever transfer what you need.

GET/api/lookup/user

Authorizations

X-API-Keyheaderstringrequired

API key from your dashboard with the lookup:user permission (granted by staff). Treat it like a password.

Query Parameters

typequerystringrequired

How to interpret value. One of username, uid, or id. Username matching is case-insensitive and falls back to aliases.

valuequerystringrequired

The lookup value: a username, a numeric uid, or an internal user id. 1–64 characters.

profilequeryboolean

Include the active profile (display name, description, theme, fonts, and resolved asset URLs). Pass the literal string true. Defaults to false.

badgesqueryboolean

Include the user's enabled badges. Pass true. Defaults to false.

widgetsqueryboolean

Include the active profile's widgets. Pass true. Defaults to false.

audiosqueryboolean

Include the active profile's audio tracks. Pass true. Defaults to false.

backgroundsqueryboolean

Include the active profile's backgrounds. Pass true. Defaults to false.

linksqueryboolean

Include the active profile's links. Pass true. Defaults to false.

projectsqueryboolean

Include the active profile's projects. Pass true. Defaults to false.

viewsqueryboolean

Include the profile view count. Pass true. Defaults to false.

aliasesqueryboolean

Include the user's aliases. Pass true. Defaults to false.

skillsqueryboolean

Include the active profile's skills. Pass true. Defaults to false.

Only the sections you opt into are queried and serialized, so the default payload stays small. Include flags are read as exact strings — pass true (e.g. profile=true); any other value is treated as false.

Example Request

Request

curl -X GET "https://haunt.gg/api/lookup/user?type=username&value=john&profile=true" \
  -H "X-API-Key: YOUR_API_KEY"

Response

User found. Basic payload (no include flags).

{
  "error": null,
  "user": {
    "id": "clz9k2x0a0000s601f8h3d7q2",
    "uid": 1337,
    "username": "john",
    "name": "John",
    "avatarUrl": "https://assets.haunt.gg/avatars/john.png",
    "discordId": "1363890885443452989",
    "premium": true,
    "verified": false,
    "imagehost": false,
    "createdAt": "2026-01-15T10:30:00.000Z"
  }
}