# List group members

`GET /group.members`

## Description

List members in a group.

Apps may list members if one of the following conditions is true:
1. It is a public group in their Roam.
2. They are a member of the group.

**Access:** Organization only.

**Required scope:** `groups:read`

---

**OpenAPI Spec:** [chat.json](https://developer.ro.am/chat.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `group` | query | TaggedUUID | No | Group ID. |
| `limit` | query | integer | No | The number of members to return per response. Default is 10. |
| `cursor` | query | string | No | Opaque pagination cursor from a previous response's `nextCursor`. Do not construct cursors manually. |

## Responses

### 200 - Info retrieved successfully

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `members` | TaggedUUID[] | No |  |
| `nextCursor` | string | No |  |

**TaggedUUID** (array item):

A UUID prefixed by a tag identifying the specific type of object

#### Example Response

```json
{
  "members": [
    "U-709b8a57-70bc-427a-b6f0-b16ba5297f8c",
    "U-af6663d5-0f37-4105-95df-4fea20ef7c7c",
    "U-f589a8cb-78ac-493e-8719-0fa8a22f65e0"
  ],
  "nextCursor": "abc123"
}
```

### 400 - Invalid request, e.g. group does not exist.

### 401 - Unauthorized.

### 403 - App does not have access to this group.

### 500 - An internal error occured.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/chat-api/group-members*