GET /v1/bots/{clientId}/status

Quick check if a bot is currently online (public bots only)

Path parameters

  • clientId string Required

    Discord bot client ID

Responses

  • 200 application/json

    Bot status

    Hide response attributes Show response attributes object
    • success boolean
    • data object
      Hide data attributes Show data attributes object
      • online boolean

        Whether bot is online (heartbeat within 5 minutes)

      • lastSeen string(date-time)

        Last heartbeat timestamp

    • 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}/status 
curl \
 --request GET 'https://api.4mina.app/v1/bots/{clientId}/status'
Response examples (200) 
{
  "success": true,
  "data": {
    "online": true,
    "lastSeen": "2025-05-04T09:42:00Z"
  },
  "meta": {
    "generatedAt": "2025-05-04T09:42:00Z"
  }
}
Response examples (404) 
{
  "success": false,
  "error": {
    "message": "string",
    "code": "string"
  },
  "meta": {
    "generatedAt": "2025-05-04T09:42:00Z"
  }
}