> For the complete documentation index, see [llms.txt](https://docs.etelecom.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.etelecom.vn/tich-hop-api/zalo-cloud/zalo-cloud-api/lay-danh-sach-nguoi-dung.md).

# Lấy danh sách người dùng

{% hint style="info" %}
**Lưu ý:**

* Đối với các API sử dụng cho Shop thì API\_KEY: [`<api_key>`](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan#api-key).Thông tin base\_url của [Shop](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan)
* Đối với các API sử dụng cho Partner thì API\_KEY: [`<shop_key>`](https://docs.etelecom.vn/tich-hop-api/partner/su-dung#ket-noi-lan-thu-hai-tro-di).Thông tin base\_url của [Partner](https://docs.etelecom.vn/tich-hop-api/partner/tai-khoan)
  {% endhint %}

{% openapi src="/files/NU9hBvwVjJ0u1KZHFzaQ" path="$BASE\_URL.Zalo/ListFollowers" method="post" %}
[swagger (6).json](https://4211996220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9CUTEBoYNqJaZqxNp3Eh%2Fuploads%2FM3MA0yrRz1uxyAN2jSKD%2Fswagger%20\(6\).json?alt=media\&token=7af53a27-477d-4477-b6ec-157336cbb25c)
{% endopenapi %}

**Request:**

```json
curl --location '$BASE_URL.Zalo/ListFollowers' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "filter": {
    "assigned_user_id": "string",
    "date_from": "2019-08-24T14:15:22Z",
    "date_to": "2019-08-24T14:15:22Z",
    "gender": "unknown",
    "has_conversation": true,
    "name": "string",
    "oa_id": "string",
    "phone": "string",
    "state": "follow",
    "tags": [
      "string"
    ],
    "zl_user_id": "string",
    "zl_user_ids": [
      "string"
    ]
  },
  "paging": {
    "after": "string",
    "before": "string",
    "limit": 0,
    "sort": "string"
  }
}'
```

**Response:**

```json
{
  "followers": [
    {
      "assigned_user_id": "string",
      "avatar": "string",
      "avatars": {
        "120": "string",
        "240": "string"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "full_name": "string",
      "gender": "unknown",
      "has_conversation": true,
      "id": "string",
      "oa_id": "string",
      "phone": "string",
      "shared_info": {
        "address": "string",
        "city": "string",
        "district": "string",
        "name": "string",
        "phone": "string",
        "ward": "string"
      },
      "shop_id": "string",
      "state": "follow",
      "tags_and_notes_info": {
        "notes": [
          "string"
        ],
        "tag_names": [
          "string"
        ]
      },
      "updated_at": "2019-08-24T14:15:22Z",
      "zl_user_id": "string",
      "zl_user_id_by_app": "string"
    }
  ],
  "paging": {
    "after": "string",
    "before": "string",
    "limit": 0,
    "next": "string",
    "prev": "string",
    "sort": "string"
  }
}
```

**Cấu trúc body của request**

<table><thead><tr><th width="234.33333333333331">Tham số</th><th width="201">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>assigned_user_id</td><td>string</td><td>ID nhân viên được gán</td></tr><tr><td>oa_id</td><td>int64</td><td>ID của OA</td></tr><tr><td>name</td><td>string</td><td>Tên người dùng Zalo</td></tr><tr><td>date_from</td><td>string&#x3C;date-time></td><td>Ngày bắt đầu</td></tr><tr><td>date_to</td><td>string&#x3C;date-time></td><td>Ngày kết thúc</td></tr><tr><td>gender</td><td>string (pwGender) Enum</td><td>Giới tính<br><mark style="color:red;"><strong>"</strong><strong><code>unknown</code></strong><strong>" "</strong><strong><code>male</code></strong><strong>" "</strong><strong><code>female</code></strong><strong>" "</strong><strong><code>other</code></strong><strong>"</strong></mark></td></tr><tr><td>has_conversation</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Có cuộc hội thoại</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Không có cuộc hội thoại</p></td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người dùng</td></tr><tr><td>state</td><td>string (gqFollowState) Enum</td><td><p><mark style="color:red;"><strong><code>follow</code></strong></mark><strong>:</strong> Đã quan tâm</p><p><mark style="color:red;"><strong><code>unfollow</code></strong></mark><strong>:</strong> Chưa quan tâm</p></td></tr><tr><td>tags</td><td>Array of strings</td><td>Nhãn được gán cho người dùng</td></tr><tr><td>zl_user_id</td><td>string</td><td>ID người dùng Zalo</td></tr></tbody></table>

**Cấu trúc thuộc tính dữ liệu trả về**

<table><thead><tr><th width="234.33333333333331">Tham số</th><th width="201">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>assigned_user_id</td><td>string</td><td>ID nhân viên được gán</td></tr><tr><td>avatar</td><td>string</td><td>Ảnh đại diện người dùng</td></tr><tr><td>full_name</td><td>string</td><td>Tên người dùng</td></tr><tr><td>id</td><td>string</td><td>ID người dùng trên eTelecom</td></tr><tr><td>oa_id</td><td>int64</td><td>ID của OA</td></tr><tr><td>shared_info</td><td>object (mrSharedInfo)</td><td>Người dùng đồng ý chia sẻ thông tin</td></tr><tr><td>address</td><td>string</td><td>Địa chỉ</td></tr><tr><td>city</td><td>string</td><td>Thành phố</td></tr><tr><td>district</td><td>string</td><td>Quận, Huyện</td></tr><tr><td>ward</td><td>string</td><td>Phường</td></tr><tr><td>name</td><td>string</td><td>Tên người dùng Zalo</td></tr><tr><td>created_at</td><td>string&#x3C;date-time></td><td>Thời điểm ghi nhận tương tác</td></tr><tr><td>updated_at</td><td>string&#x3C;date-time></td><td>Thời điểm update</td></tr><tr><td>gender</td><td>string (pwGender) Enum</td><td>Giới tính<br><mark style="color:red;"><strong>"</strong><strong><code>unknown</code></strong><strong>" "</strong><strong><code>male</code></strong><strong>" "</strong><strong><code>female</code></strong><strong>" "</strong><strong><code>other</code></strong><strong>"</strong></mark></td></tr><tr><td>has_conversation</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Có cuộc hội thoại</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Không có cuộc hội thoại</p></td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người dùng</td></tr><tr><td>shop_id</td><td>string</td><td>ID shop trên eTelecom</td></tr><tr><td>state</td><td>string (gqFollowState) Enum</td><td><p><mark style="color:red;"><strong><code>follow</code></strong></mark><strong>:</strong> Đã quan tâm</p><p><mark style="color:red;"><strong><code>unfollow</code></strong></mark><strong>:</strong> Chưa quan tâm</p></td></tr><tr><td>tags</td><td>Array of strings</td><td>Nhãn được gán cho người dùng</td></tr><tr><td>zl_user_id</td><td>string</td><td>ID người dùng Zalo</td></tr><tr><td>zl_user_id_by_app</td><td>string</td><td>ID người dùng Zalo theo app</td></tr></tbody></table>