# List group members

`GET https://app.whatsetter.com/api/v1/groups/{id}/members`

Participants of one group (phone, display name, role, whether they
are still in the group), most recently added first. Filter
`status=active` or `status=left`. Requires scope `groups:read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes |  |
| `status` | query | active \| left | no |  |
| `limit` | query | integer | no |  |
| `cursor` | query | string | no | Opaque cursor from the previous page's `pagination.next_cursor`. |

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/groups/{id}/members' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: Page of members

```json
{
  "data": [
    {
      "id": "",
      "phone": "",
      "name": "",
      "role": "superadmin",
      "status": "active",
      "joined_at": "",
      "left_at": "",
      "joined_source": "",
      "messages_count": 0
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": ""
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 422: Invalid parameter or body (also an invalid or expired `cursor`)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listgroupmembers/
