> For the complete documentation index, see [llms.txt](https://doc.thordata.com/interface-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/interface-documentation/public-api/whitelist-ips/add-whitelist-ip.md).

# Add Whitelist IP

### Basic Information

**Interface Description:** Add Thordata residential proxy, unlimited proxy server, and mobile proxy whitelist IPs through the interface

**Interface URL:** <https://openapi.thordata.com/api/whitelisted-ips/add-ip>

**Request Method:** <mark style="color:orange;">POST</mark>

### Request parameters

**Headers：**

<table><thead><tr><th>Parameter name</th><th width="163">Type</th><th width="127">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>token</code></td><td>string</td><td>Yes</td><td>Please log in to the  <a href="https://dashboard.thordata.com/account-settings"><strong>Dashboard-MENU-My Account</strong></a> to view your token parameter value</td></tr></tbody></table>

**Body：**

<table><thead><tr><th>Parameter name</th><th width="175">Type</th><th width="110">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>proxy_type</code></td><td>number</td><td>Yes</td><td>Select the proxy type: 1 is Residential Proxies, 2 is Unlimited Proxy servers,9 is Mobile Proxies(default is 1)</td></tr><tr><td><code>ip</code></td><td>string</td><td>Yes</td><td>IP information to be added</td></tr><tr><td><code>status</code></td><td>string</td><td>Yes</td><td>Whitelist IP status, true is enabled, false is disabled</td></tr></tbody></table>

### Response example

```json
{
    "code": 200,
    "data": {},
    "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 %}

<table><thead><tr><th width="206">Parameter name</th><th>Type</th><th width="139">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>code</code></td><td>number</td><td>No</td><td>-</td></tr><tr><td><code>data</code></td><td>object</td><td>No</td><td>-</td></tr><tr><td><code>msg</code></td><td>string</td><td>No</td><td>-</td></tr></tbody></table>