Skip to main content
Community endpoints are public — no authentication is required. They are rate-limited to 30 requests per minute per IP and use Redis caching to reduce database load.

​
GET /community/:guildId/leaderboard

Returns the top members ranked by XP. Only members who have opted into a public profile are included. Authentication: None required.

​
Path parameters

​
guildId
string
required
The Discord guild ID.

​
Query parameters

​
page
integer
Page number. Default: 1. Minimum: 1.
​
limit
integer
Members per page. Default: 25. Range: 1–100.

​
Response fields

​
members
array
Ranked list of members.
​
total
integer
Total number of members with public profiles.
​
page
integer
Current page.

​
Example

curl "https://volvox.bot/api/v1/community/987654321098765432/leaderboard?limit=5"

{
  "members": [
    {
      "userId": "111000111",
      "username": "alice",
      "displayName": "Alice",
      "avatar": "https://cdn.discordapp.com/avatars/111000111/abc.png",
      "xp": 15200,
      "level": 8,
      "badge": "⭐ Expert",
      "rank": 1,
      "currentLevelXp": 12000,
      "nextLevelXp": 20000
    }
  ],
  "total": 87,
  "page": 1
}

​
GET /community/:guildId/showcases

Returns the community project showcase gallery sorted by upvotes or recency. Only projects from members with public profiles are included. Authentication: None required.

​
Path parameters

​
guildId
string
required
The Discord guild ID.

​
Query parameters

​
page
integer
Page number. Default: 1.
​
limit
integer
Projects per page. Default: 12. Range: 1–50.
​
sort
string
Sort order. Options: upvotes, recent. Default: upvotes.

​
Response fields

​
projects
array
List of showcase projects.
​
total
integer
Total projects available.
​
page
integer
Current page.

​
Example

curl "https://volvox.bot/api/v1/community/987654321098765432/showcases?sort=recent&limit=6"

{
  "projects": [
    {
      "id": 42,
      "title": "DevBot Dashboard",
      "description": "A real-time dashboard for monitoring Discord bots.",
      "tech": ["React", "Node.js", "PostgreSQL"],
      "repoUrl": "https://github.com/alice/devbot-dashboard",
      "liveUrl": "https://devbot.example.com",
      "authorName": "Alice",
      "authorAvatar": "https://cdn.discordapp.com/avatars/111000111/abc.png",
      "upvotes": 34,
      "createdAt": "2026-02-14T10:00:00.000Z"
    }
  ],
  "total": 23,
  "page": 1
}

​
GET /community/:guildId/stats

Returns aggregate community statistics including member count, total messages, active projects, challenges completed, and top contributors. Authentication: None required.

​
Path parameters

​
guildId
string
required
The Discord guild ID.

​
Response fields

​
memberCount
integer
Number of members with public profiles.
​
totalMessagesSent
integer
All-time cumulative message count across all tracked guild members.
​
activeProjects
integer
Number of public showcase projects from members with public profiles.
​
challengesCompleted
integer
Total challenge completions in the guild.
​
topContributors
array
Top 3 contributors by XP. Each item has userId, username, displayName, avatar, xp, level, and badge.

​
Example

curl "https://volvox.bot/api/v1/community/987654321098765432/stats"

{
  "memberCount": 87,
  "totalMessagesSent": 412500,
  "activeProjects": 23,
  "challengesCompleted": 61,
  "topContributors": [
    {
      "userId": "111000111",
      "username": "alice",
      "displayName": "Alice",
      "avatar": "https://cdn.discordapp.com/avatars/111000111/abc.png",
      "xp": 15200,
      "level": 8,
      "badge": "⭐ Expert"
    }
  ]
}

​
GET /community/:guildId/profile/:userId

Returns a user’s public profile including stats, XP progression, activity badges, and project showcases. Returns 404 if the user has not opted into a public profile. Authentication: None required.

​
Path parameters

​
guildId
string
required
The Discord guild ID.
​
userId
string
required
The Discord user ID.

​
Response fields

​
username
string
Discord username.
​
displayName
string
Guild display name.
​
avatar
string | null
Avatar URL.
​
xp
integer
Total XP earned.
​
level
integer
Current level.
​
currentLevelXp
integer
XP threshold for the current level.
​
nextLevelXp
integer
XP threshold for the next level.
​
badge
string
Level badge label.
​
joinedAt
string | null
ISO 8601 timestamp when the user joined the guild.
​
stats
object
Activity stats with messagesSent, reactionsGiven, reactionsReceived, and daysActive.
​
projects
array
Up to 10 most recent showcase projects from this user.
​
recentBadges
array
Activity milestone badges earned. Each item has name and description.

​
Example

curl "https://volvox.bot/api/v1/community/987654321098765432/profile/111000111"

{
  "username": "alice",
  "displayName": "Alice",
  "avatar": "https://cdn.discordapp.com/avatars/111000111/abc.png",
  "xp": 15200,
  "level": 8,
  "currentLevelXp": 12000,
  "nextLevelXp": 20000,
  "badge": "⭐ Expert",
  "joinedAt": "2025-01-15T00:00:00.000Z",
  "stats": {
    "messagesSent": 2400,
    "reactionsGiven": 310,
    "reactionsReceived": 180,
    "daysActive": 45
  },
  "projects": [
    {
      "id": 42,
      "title": "DevBot Dashboard",
      "description": "A real-time dashboard.",
      "tech": ["React", "Node.js"],
      "repoUrl": "https://github.com/alice/devbot-dashboard",
      "liveUrl": null,
      "upvotes": 34,
      "createdAt": "2026-02-14T10:00:00.000Z"
    }
  ],
  "recentBadges": [
    { "name": "💬 Chatterbox", "description": "1,000+ messages" },
    { "name": "🗓️ Monthly Regular", "description": "30+ days active" }
  ]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us