---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/nhom-chat-gmf/quan-ly/get_list_member
title: Lấy danh sách thành viên nhóm
---
# Lấy danh sách thành viên nhóm

:::warning Lưu ý
Ứng dụng cần được cấp quyền quản lý thông tin nhóm.
:::

## HTTP request

- **URL:** [https://openapi.zalo.me/v3.0/oa/group/listmember](//openapi.zalo.me/v3.0/oa/group/listmember)
- **Method:** GET
- **Response Type:** text/json

## Example request

```bash
curl --request GET 'https://openapi.zalo.me/v3.0/oa/group/listmember?group_id=f414c8f76fa586fbdfb4&offset=0&count=5' \
--header 'access_token: <your_access_token>'
```

### Tham số header

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| [access_token](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) | string | yes | Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token [tại đây](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new). |


### Tham số

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| group_id | string | yes | ID của nhóm |
| offset | integer | optional | Offset muốn query. Mặc định: 0 |
| count | integer | optional | Số lượng mong muốn query. Mặc định: 5 |


## Example respond

```json
{
    "data": {
        "offset": 0,
        "count": 5,
        "total": 2,
        "member_count": 2,
        "members": [
            {
                "oa_id": "607812198688816074",
                "name": "Chủ Trại Mèo",
                "avatar": "https://s120-ava-talk.zadn.vn/d/e/f/d/7/120/380ffb601008ba5c58852a80cb635b79.jpg"
            },
            {
                "user_id": "8756287263669629130",
                "name": "Hoàng Trường Phước",
                "avatar": "https://s120-ava-talk.zadn.vn/8/0/d/7/2/120/59fc092d056c759a71fd16d3bc508458.jpg"
            }
        ]
    },
    "error": 0,
    "message": "Success"
}
```

### Cấu trúc thuộc tính data

| Tham số | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| offset | integer | offset muốn query |
| count | integer | Số lượng muốn query |
| total | integer | Tổng số lượng các thành viên trong nhóm |
| members | array | Thông tin các thành viên trong nhóm |
| member_count | integer | Số lượng các thành viên được trả về |



### Cấu trúc thuộc tính members

| Tham số | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| name | string | Tên thành viên trong nhóm |
| user_id | string | ID thành viên chờ trong nhóm |
| oa_id | string | ID của OA |
| avatar | string | Hình đại diện của thành viên trong nhóm |

####