GET /v1/bots/{clientId}

Returns detailed information about a specific bot (public bots only)

Path parameters

  • clientId string Required

    Discord bot client ID

Responses

  • 200 application/json

    Bot information with current stats

    Hide response attributes Show response attributes object
    • success boolean
    • data object
      Hide data attribute Show data attribute object
      • bot object
        Hide bot attributes Show bot attributes object
        • clientId string

          Discord bot client ID

        • name string

          Bot display name

        • avatar string | null

          Bot avatar URL (Discord CDN)

        • ownerId string

          Discord user ID of bot owner

        • registeredAt string(date-time)

          When the bot was registered with the API

        • lastSeen string(date-time)

          Last heartbeat timestamp

        • version string

          Bot version string

        • inviteUrl string(uri)

          Bot invite URL

        • supportServer string(uri)

          Support server invite link

        • website string(uri)

          Bot website URL

        • isPublic boolean

          Whether the bot is listed publicly

        • features array[string]

          Bot feature tags

        • 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 or not public

    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}
curl \
 --request GET 'https://api.4mina.app/v1/bots/{clientId}'
Response examples (200)
{
  "success": true,
  "data": {
    "bot": {
      "clientId": "1234567890123456789",
      "name": "Amina",
      "avatar": "https://cdn.discordapp.com/avatars/...",
      "ownerId": "9876543210987654321",
      "registeredAt": "2025-05-04T09:42:00Z",
      "lastSeen": "2025-05-04T09:42:00Z",
      "version": "1.0.0",
      "inviteUrl": "https://discord.com/oauth2/authorize?client_id=...",
      "supportServer": "https://discord.gg/...",
      "website": "https://example.com",
      "isPublic": true,
      "features": [
        "moderation",
        "music",
        "leveling"
      ],
      "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"
  }
}