WRLDTrace API Documentation

Base URL

wt.luca.click/api

Authentication

No authentication required. All endpoints are publicly accessible.

Endpoints

GET /api/lookup/<user_id>

Get complete user information including profile, badges, and clan data.

Parameters

user_id Discord User ID (17-19 digits, required)

Example Request

GET /api/lookup/227823673690554368

Example Response

{
  "success": true,
  "user": {
    "id": "227823673690554368",
    "username": "beatsbyluca",
    "global_name": "Lxca",
    "discriminator": "0",
    "avatar": "814b024013c6fd6f0785ab618eae5d4f",
    "banner": "d679f43d0ac26e397704c7650e78d458",
    "accent_color": 3937445,
    "banner_color": 1907488,
    "flags": 0,
    "public_flags": 0,
    "flags_list": [],
    "public_flags_list": [],
    "created_at": "04. Nov 2015, 12:00 UTC",
    "clan": {
      "name": "999",
      "id": "1369730373541691583",
      "badge": "002d0780cd2de931349a5e5e86e52774"
    },
    "primary_guild": {
      "name": "999",
      "id": "1369730373541691583",
      "badge": "002d0780cd2de931349a5e5e86e52774"
    }
  },
  "badges": []
}

GET /api/v1/user/<user_id>

Get complete user information (same as /api/lookup/<user_id>).

GET /api/v1/user/<user_id>/badges

Get only badges for a specific user.

Example Response

{
  "success": true,
  "user_id": "227823673690554368",
  "badges": [
    {
      "name": "Active Developer",
      "image": "activedeveloper.png",
      "color": "#23a55a"
    }
  ]
}

GET /api/v1/user/<user_id>/avatar

Get avatar URL for a specific user.

Example Response

{
  "success": true,
  "user_id": "227823673690554368",
  "avatar_url": "https://cdn.discordapp.com/avatars/227823673690554368/814b024013c6fd6f0785ab618eae5d4f.png?size=256",
  "avatar_hash": "814b024013c6fd6f0785ab618eae5d4f"
}

GET /api/v1/user/<user_id>/banner

Get banner URL or banner color for a specific user.

Example Response

{
  "success": true,
  "user_id": "227823673690554368",
  "has_banner": true,
  "banner_url": "https://cdn.discordapp.com/banners/227823673690554368/d679f43d0ac26e397704c7650e78d458.png?size=1024",
  "banner_hash": "d679f43d0ac26e397704c7650e78d458"
}

GET /api/health

Check API health status.

Example Response

{
  "status": "healthy",
  "service": "WRLDTrace API",
  "version": "1.0.0"
}

Error Responses

All errors follow a consistent format:

{
  "error": "Error Type",
  "message": "Human-readable error message"
}

400 Bad Request - Invalid user ID format

401 Unauthorized - Bot token required

404 Not Found - User not found or private

500 Internal Server Error

Rate Limiting

Currently no rate limits are enforced. Please use responsibly.

Response Format

All responses are in JSON format with UTF-8 encoding.