List Registered Groups

GET/groups

The user's registered groups, most recently refreshed first.

Groups the user registered on LifeBots — on their own bot or a SharedBot — acted on through the bot that runs each group. Commands fail with GROUP_NOT_ACTIVE unless the group's status is running. For any group the user's own bot is in, registered or not, use Bots — Group Moderation.

Usage

1
2

curl "https://api.lifebots.cloud/api/v1/groups?page=1&limit=25" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path parameters

None.

Query parameters

Name	Type	Required	Description
`page`	integer	no	Page number, from 1.
`limit`	integer	no	Items per page, max 100.

Example response

{
  "success": true,
  "data": {
    "groups": [
      {
        "groupId": "a1b2c3d4-0000-4000-8000-000000000001",
        "groupName": "My Group",
        "groupDesc": "Welcome to My Group!",
        "groupImg": "c1d2e3f4-0000-4000-8000-000000000004",
        "memberCount": 120,
        "status": "running",
        "expiryDate": "2026-11-01T00:00:00.000Z",
        "expired": false,
        "groupType": "shared",
        "groupPowers": [
          "Invite",
          "Eject",
          "SendNotices",
          "ReceiveNotices",
          "JoinChat"
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 25,
      "total": 1,
      "totalPages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  },
  "meta": {
    "timestamp": "2026-10-02T12:00:00.000Z",
    "version": "1.0"
  }
}

status is running, un-paid, expired, no-bot-in-group, powerMissing, pending or pending-join. groupType is personal (the user's own bot) or shared (a SharedBot). groupPowers is the hosting bot's powers as stored when the group was registered or last refreshed on lifebots.cloud — it is not updated live.

Always check success; for commands the bot carries out, also check data.result. See Responses & errors.