GET /v1/bots/{clientId}/commands

Returns list of commands for a specific bot (public bots only)

Path parameters

  • clientId string Required

    Discord bot client ID

Responses

  • 200 application/json

    Bot commands

    Hide response attributes Show response attributes object
    • success boolean
    • data object
      Hide data attributes Show data attributes object
      • commands array[object]
        Hide commands attributes Show commands attributes object
        • name string
        • description string
        • category string
        • usage string
        • examples array[string]
        • aliases array[string]
        • cooldown integer

          Cooldown in seconds

        • permissions array[string]
        • botPermissions array[string]
        • nsfw boolean
        • ownerOnly boolean
      • categories array[string]
      • totalCommands integer
      • lastUpdated string(date-time)
    • meta object
      Hide meta attribute Show meta attribute object
      • generatedAt string(date-time)
  • 404 application/json

    Bot not found, not public, or commands 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}/commands 
curl \
 --request GET 'https://api.4mina.app/v1/bots/{clientId}/commands'
Response examples (200) 
{
  "success": true,
  "data": {
    "commands": [
      {
        "name": "ping",
        "description": "Check bot latency",
        "category": "Utilities",
        "usage": "/ping",
        "examples": [
          "string"
        ],
        "aliases": [
          "string"
        ],
        "cooldown": 42,
        "permissions": [
          "string"
        ],
        "botPermissions": [
          "string"
        ],
        "nsfw": true,
        "ownerOnly": true
      }
    ],
    "categories": [
      "Moderation",
      "Utilities",
      "Fun"
    ],
    "totalCommands": 50,
    "lastUpdated": "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"
  }
}