# Users Query

### Basic Information

**Interface Description:** Query the list of residential proxy users through the interface

**Interface URL:** <https://api.thordata.com/api/child/user\\_list>

**Request Method:** GET

### Request parameters

**Query：**

| Parameter name | Type   | Required | Describe                                                                                                                                               |
| -------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sign`         | string | Yes      | Please log in to the [**Dashboard - Settings - Account Details**](https://dashboard.thordata.com/account-settings) to view your sign parameter value   |
| `apiKey`       | string | Yes      | Please log in to the [**Dashboard - Settings - Account Details**](https://dashboard.thordata.com/account-settings) to view your apiKey parameter value |

### Response example

```
{
    "code": 200,
    "data": {
        "count": 2,
        "limit": 100,
        "list": [
            {
                "flow_limit": 0,
                "password": "thordata2",
                "status": 1,
                "username": "thordata2"
            },
            {
                "flow_limit": 0,
                "password": "thordata1",
                "status": 1,
                "username": "thordata1"
            }
        ]
    },
    "msg": "ok"
}
```

{% hint style="info" %}
If the returned code value is not 200, please check the [**error code description list**](https://doc.thordata.com/interface-documentation/error-code/error-code-description) and modify it.
{% endhint %}

| Parameter name | Type       | Required | Describe                            |
| -------------- | ---------- | -------- | ----------------------------------- |
| `code`         | number     | No       |                                     |
| `data`         | object     | No       |                                     |
| `count`        | number     | No       | Total number of users               |
| `limit`        | number     | No       | Maximum number of users             |
| `list`         | object \[] | No       |                                     |
| `flow_limit`   | number     | Yes      | Use traffic limits (MB)             |
| `password`     | string     | Yes      |                                     |
| `username`     | string     | Yes      |                                     |
| `status`       | string     |          | User status: 1 enabled, -2 disabled |
| `msg`          | string     | No       |                                     |