Users

Admin endpoints to search for accounts and inspect user metadata.

Auth

All routes require a valid API JWT with admin:user:view.

Lookup users

GET /v1/admin/users/lookup?query={name-or-uuid}&limit=10

Searches by username prefix (case-insensitive) or a UUID. limit is optional and capped at 50.

Response:

{
  "items": [
    {
      "userId": "c959d9f9-dcbd-4054-8c4c-d5c305997bc0",
      "name": "Somebody",
      "homeRegion": "eu-central",
      "lastSeenAt": "2026-01-22T08:40:00Z"
    }
  ]
}

Get user detail

GET /v1/admin/users/{userId}

Response:

{
  "userId": "c959d9f9-dcbd-4054-8c4c-d5c305997bc0",
  "name": "Somebody",
  "homeRegion": "eu-central",
  "lastRegion": "eu-central",
  "createdAt": "2026-01-05T12:00:00Z",
  "updatedAt": "2026-01-20T12:00:00Z",
  "firstJoinedAt": "2026-01-05T12:00:00Z",
  "lastSeenAt": "2026-01-22T08:40:00Z",
  "lastRegionAt": "2026-01-22T08:40:00Z",
  "allowFriendRequests": true
}