GET /v1/bots/{clientId}/stats

Returns current statistics for a specific bot (public bots only)

Path parameters

  • clientId string Required

    Discord bot client ID

Responses

  • 200 application/json

    Bot statistics

    Hide response attributes Show response attributes object
    • success boolean
    • data object
      Hide data attribute Show data attribute object
      • stats object
        Hide stats attributes Show stats attributes object
        • guilds integer

          Number of guilds

        • members integer

          Total member count

        • channels integer

          Total channel count

        • commands integer

          Total command count

        • ping integer

          WebSocket ping in milliseconds

        • uptime integer

          Bot uptime in seconds

        • memoryUsage integer

          Memory usage in MB

        • status string

          Bot presence status

          Values are online, idle, dnd, invisible, or offline.

        • presence object
          Hide presence attributes Show presence attributes object
          • type string
          • name string
          • url string(uri)
        • lastUpdated string(date-time) | null

          When stats were last pushed, null if no stats have been reported

        • hasStats boolean

          Whether real stats have been reported (false means default fallback values)

    • meta object
      Hide meta attribute Show meta attribute object
      • generatedAt string(date-time)
  • 404 application/json

    Bot not found, not public, or stats not available

    Hide response attributes Show response attributes object
    • success boolean
    • error object
      Hide error attributes Show error attributes object
      • message string
      • code string
    • meta object
      Hide meta attribute Show meta attribute object
      • generatedAt string(date-time)
GET /v1/bots/{clientId}/stats
curl \
 --request GET 'https://api.4mina.app/v1/bots/{clientId}/stats'
Response examples (200)
{
  "success": true,
  "data": {
    "stats": {
      "guilds": 150,
      "members": 50000,
      "channels": 3000,
      "commands": 50,
      "ping": 45,
      "uptime": 86400,
      "memoryUsage": 512,
      "status": "online",
      "presence": {
        "type": "Playing",
        "name": "with commands",
        "url": "https://example.com"
      },
      "lastUpdated": "2025-05-04T09:42:00Z",
      "hasStats": true
    }
  },
  "meta": {
    "generatedAt": "2025-05-04T09:42:00Z"
  }
}
Response examples (404)
{
  "success": false,
  "error": {
    "message": "string",
    "code": "string"
  },
  "meta": {
    "generatedAt": "2025-05-04T09:42:00Z"
  }
}