GET /v1/bots

Returns a paginated list of all bots registered with the API that are marked as public.

  • Default limit: 20
  • Maximum limit: 100
  • Pagination metadata is returned under meta.

Query parameters

  • page integer

    Page number for paginated results

    Minimum value is 1. Default value is 1.

  • limit integer

    Number of bots per page (default: 20, max: 100)

    Minimum value is 1, maximum value is 100. Default value is 20.

Responses

  • 200 application/json

    Paginated list of public bots

    Hide response attributes Show response attributes object
    • success boolean
    • data object
      Hide data attribute Show data attribute object
      • bots array[object]
        Hide bots attributes Show bots 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

    • meta object
      Hide meta attributes Show meta attributes object
      • total integer

        Total number of public bots

      • page integer

        Current page number

      • limit integer

        Number of bots per page

      • pages integer

        Total number of pages

      • hasMore boolean

        Whether more pages are available
GET /v1/bots 
curl \
 --request GET 'https://api.4mina.app/v1/bots'
Response examples (200) 
{
  "success": true,
  "data": {
    "bots": [
      {
        "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"
        ]
      }
    ]
  },
  "meta": {
    "total": 123,
    "page": 1,
    "limit": 20,
    "pages": 7,
    "hasMore": true
  }
}