# group_info_2

Returns the information about Second Life group, along with roles and titles.

```csharp
// See "LSL Helper Functions" page for this function

smartbotsAPI("group_info_2", [
  "groupuuid", "0b65a122-8f77-64fe-5b2a-225d4c490d9c"
]);
```

# Variables

The following table shows input values (you send them with the API call) and returned output values.

## Input basic parameters

| Variable | Required | Description |
|----------|----------|-------------|
| action   | yes      | = group_list2 |
| apikey   | yes      | Your personal [developer's API key](/doc/developers-api-key-tw8bQj4LSJ) |
| botname  | yes      | Your bot's SL login |
| secret   | yes      | [Bot access code](https://www.mysmartbots.com/docs/Bot_access_code) of your bot |
| dataType | optional | Set to "json" to get JSON reply instead of URL-encoded string |
| custom   | optional | The custom data (string) to be passed back to caller script. This value will be returned back to the caller in HTTP response |

## Input

| Variable | Required | Description |
|----------|----------|-------------|
| groupuuid | yes      | The group UUID. |

## Output

*(To be received in* `*http_response*` *LSL event, see* [*docs for details*](/doc/doing-http-api-calls-c6FSEMF7bP)*)*

| Variable | Description |
|----------|-------------|
| result   | OK - command completed successfully<br>FAIL - command failed |
| resulttext | Detailed reason for the failure |
| custom   | The value from input "custom" parameter. See above |
| info     | JSON object containing the group info (see below) |

# Return value

This command returns complex data and is **only available** when requesting JSON output (`dataType=json`).

`info` field contains:

```typescript
interface group_info_2.Info {
	// Group UUID
	uuid: UUID;
 	// Group name
	name: string;

 	// UUID of the founder resident
	founder: UUID;
 	// UUID of the group image
	insignia: UUID;
 	// Group description
	charter: string;

	// The number of members in the group
	members: number;
 
 	// The list of the group roles (see interface below)
	roles: GroupRole[]; 
 	// The list of roles titles available to bot (see below)
	titles: GroupTitle[];
 	// Current title
	memberTitle: string;

 	// Is group open to join
	open: boolean;
 	// Join group fee
	fee: number;
 	// Is group mature
	mature: boolean;

	// Is bot a member of this group
	isMember: boolean;
}

interface GroupRole {
	// Role UUID 
	uuid: UUID;
 	// Role name
	name: string;
 	// Role descriptiom
	description: string;
 	// Role title (tag)
	title: string;
	// List of role powers in a group ('JoinChat', 'AllowRez') 
	powers: string[];
}
 
interface GroupTitle {
	// Related role UUID
	role: UUID;
 	// Title (tag)
	title: string;
 	// Is this title currently active for bot avatar
	selected: boolean;
}
```

Check [group permissions page](/doc/group-permissions-siEgAFAHaB) for a full list of permissions.

# Example

Example output:

```json
{
  "members": 8202,
  "mature": false,
  "isMember": true,
  "open": true,
  "memberTitle": "Smart VIP Partner",
  "name": "SmartBots: group invitation bots",
  "roles": [
    {
      "description": "These are the owners of the group.  They always have FULL POWER over the group.",
      "uuid": "044ad014-7298-eb70-0945-85d6df01f154",
      "title": "SmartBots CEO",
      "name": "Owners",
      "powers": [
        "Invite",
        "Eject",
        "ChangeOptions",
        "CreateRole",
        "DeleteRole",
        "RoleProperties",
        "AssignMemberLimited",
        "AssignMember",
        "RemoveMember",
        "ChangeActions",
        "ChangeIdentity",
        "LandDeed",
        "LandRelease",
        "LandSetSale",
        "LandDivideJoin",
        "JoinChat",
        "FindPlaces",
        "LandChangeIdentity",
        "SetLandingPoint",
        "ChangeMedia",
        "LandEdit",
        "LandOptions",
        "AllowEditLand",
        "AllowFly",
        "AllowRez",
        "AllowLandmark",
        "AllowVoiceChat",
        "AllowSetHome",
        "LandManageAllowed",
        "LandManageBanned",
        "LandManagePasses",
        "LandEjectAndFreeze",
        "ReturnGroupSet",
        "ReturnNonGroup",
        "LandGardening",
        "DeedObject",
        "ModerateChat",
        "ObjectManipulate",
        "ObjectSetForSale",
        "Accountable",
        "HostEvent",
        "SendNotices",
        "ReceiveNotices",
        "StartProposal",
        "VoteOnProposal",
        "MemberVisible",
        "ReturnGroupOwned",
        "ExperienceAdmin",
        "ExperienceCreator",
        "GroupBanAccess"
      ]
    },
    {
      "uuid": "10d7e54f-7c52-8f0e-7ad8-7e0059664cd0",
      "description": "",
      "title": "SmartBots",
      "powers": [
        "Invite",
        "Eject",
        "AssignMemberLimited",
        "RemoveMember",
        "ModerateChat",
        "SendNotices",
        "MemberVisible"
      ],
      "name": "SmartBots"
    },
    {
      "powers": [
        "Eject",
        "AssignMemberLimited",
        "RemoveMember",
        "ModerateChat",
        "SendNotices",
        "MemberVisible"
      ],
      "name": "Senior Support",
      "title": "+SmartBots Support+",
      "uuid": "73d95c88-1a38-5227-234d-76ae665bc50f",
      "description": ""
    },
    {
      "uuid": "7aeed271-efa4-b732-526f-a5dbe98436c8",
      "description": "",
      "title": "SmartBots Support",
      "name": "Support Managers",
      "powers": [
        "Eject",
        "ModerateChat",
        "SendNotices",
        "MemberVisible"
      ]
    },
    {
      "description": "",
      "uuid": "aebb8d51-c3b6-74cb-cc66-9c30584b5542",
      "title": "Alive SmartBot",
      "name": "Alive Bots",
      "powers": [
        "MemberVisible"
      ]
    },
    {
      "powers": [
        "Invite"
      ],
      "name": "Support Bot",
      "title": "Right-click & IM me!",
      "description": "",
      "uuid": "aef5b7a6-f0c4-b847-5953-1d490f0b3485"
    },
    {
      "name": "Developers",
      "powers": [
        "MemberVisible"
      ],
      "title": "SmartBots Developer",
      "description": "",
      "uuid": "ba093feb-680a-a321-086a-c0343a96f960"
    },
    {
      "name": "Barkeeper Bot",
      "powers": [],
      "title": "Touch me for a drink",
      "uuid": "d3ddc55d-0152-d735-57f6-62eb692237f3",
      "description": ""
    },
    {
      "name": "Personal bot",
      "powers": [],
      "description": "",
      "uuid": "eaa86b3b-1408-fb4f-3118-7dadabf65fec",
      "title": "I'm Personal Bot"
    },
    {
      "powers": [
        "Invite",
        "JoinChat",
        "ReceiveNotices"
      ],
      "name": "Everyone",
      "title": "Smart VIP Partner",
      "uuid": "00000000-0000-0000-0000-000000000000",
      "description": "Everyone in the group is in the everyone role."
    }
  ],
  "insignia": "bf41fd15-3edb-c1d0-d4d9-fe9fbe5a96e6",
  "titles": [
    {
      "role": "00000000-0000-0000-0000-000000000000",
      "selected": true,
      "title": "Smart VIP Partner"
    }
  ],
  "founder": "cd93067e-7c4e-41c0-ba91-be01f4bafe35",
  "charter": "Direct group inviter  just for L$79 per week! Plus chat manager, notice sender and a lot of unique features:\n\n- chat control using web browser\n- automatic scheduled notices\n- spamless (respects parcel borders)\n- only 1-prim object is required on your parcel\n\nVisit us at http://www.smartbots2life.com\nOffice: DuoLife/204/98/32",
  "uuid": "0b65a122-8f77-64fe-5b2a-225d4c490d9c",
  "fee": 0
}
```

---

**Documents**

- [Group permissions](https://sb-docs-dev.getoutline.com/s/dev/doc/group-permissions-siEgAFAHaB)