---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/extension/advanced/get-admin-list
title: Lấy danh sách admin
---
# Lấy danh sách admin

API này cho phép bạn lấy danh sách admin của Official Account (OA) với các quyền quản lý khác nhau.

## Thông tin Request

### Thông tin Request — HTTP

```
GET https://EXTENSION.zalo.me/v1.0/oa/admin/getlist
```

### Thông tin Request — cURL

```http
  curl --location --globoff 'https://openapi.zalo.me/v1.0/oa/admin/getlist?data={"user_id":"186729651760683225","role_name": "MANAGER"}' \ --header 'access_token: <your_oa_accesstoken>'
  ```



### Headers

| Tham số       | Kiểu dữ liệu | Bắt buộc | Mô tả                                      |
|--------------|-------------|----------|-------------------------------------------|
| access_token | string      | Có       | Token cho phép ứng dụng đại diện OA gọi API |

### Query Parameters

| Tham số   | Kiểu dữ liệu | Bắt buộc | Mô tả |
|-----------|-------------|----------|------------------------------------------------------------------------------------------------|
| role_name | string      | Không    | Quyền quản lý OA, hỗ trợ lọc các giá trị: MANAGER, MODERATOR, INSIGHT_ANALYST, ADVERTISER, CUSTOMER SERVICE, AGENCY |
| user_id   | string      | Không    | ID của admin cụ thể cần truy xuất thông tin |

:::info Thông tin:
Tham khảo danh sách các quyền quản lý OA [tại đây](https://oa.zalo.me/home/documents/vie/guides/quan-ly-admin-oa_83).
:::

## Response

### Cấu trúc Response

```json
{
  "data": [
    {
      "admin_id": "186729651760683225",
      "role_name": "MANAGER"
    }
  ],
  "error": 0,
  "message": "Success"
}
```

### Các trường trong Response

| Trường         | Kiểu dữ liệu | Mô tả |
|---------------|-------------|------------------------------------------------|
| data          | array       | Danh sách tất cả admin thỏa điều kiện truyền vào |
| data.admin_id | string      | ID của admin |
| data.role_name | string     | Phân quyền của admin |
| error         | number      | Mã lỗi (0 nếu thành công) |
| message       | string      | Thông báo kết quả |

## Ví dụ

### Ví dụ — Request

```bash
curl --location --globoff 'https://openapi.zalo.me/v1.0/oa/admin/getlist?data={"role_name": "MANAGER"}' \ --header 'access_token: &lt;your_oa_accesstoken&gt;'
```

### Ví dụ — Response

```json
{
      "data": [
        {
          "admin_id": "186729651760683225",
          "role_name": "MANAGER"
        }
      ],
      "error": 0,
      "message": "Success"
    }
```


:::tip Mẹo
Sử dụng API này cùng với API Truy xuất danh sách người dùng để lấy thêm thông tin chi tiết của admin.
:::