> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/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/doc/proxies/residential-proxies/whitelisted-ips.md).

# Whitelisted IPs

This guide provides key details and procedures for accessing Thordata's **Dynamic Residential Proxy** service via **Whitelisted IPs**

{% stepper %}
{% step %}

### Register ＆ Log in

Visit the [<mark style="color:blue;">**Thordata website**</mark>](https://www.thordata.com/), complete account registration, and log in.

<div align="left"><figure><img src="/files/lj8L7OlUfi5emWsa944h" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/c0zHR2dDFlNgm8b1Goys" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Purchase a Plan

Navigate within your dashboard to: **Proxies → Residential Proxies → Pricing**. Select a plan that fits your business requirements, complete payment, and activate the service.

<div align="left"><figure><img src="/files/tn1FvCHLidRkeAYT9mOw" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **Whitelist IP Configuration**

#### **Add Whitelisted IPs**

① Navigate to **Proxies → Residential Proxies → Proxy Setup → Whitelist** in your dashboard. Click **Batch Add**

<div align="left"><figure><img src="/files/IxrCVBdxyUQBNV0a6Hn3" alt="" width="375"><figcaption></figcaption></figure></div>

\
② Enter valid IP addresses in the required format.

<div align="left"><figure><img src="/files/4ItShd5HbDlRqY4coiBe" alt="" width="375"><figcaption></figcaption></figure></div>

#### **Manage Whitelisted IPs**

① **Filter** by Date: Set start/end dates to find IPs added within a specific period.

② **Search** by IP: Enter a full IP address to locate a specific entry.

③ **Edit** : Click **Edit** to update IP address, status (Enabled/Disabled), or notes.

④ **Delete** :

* Single IP: Click **Delete** within the edit view.
* Bulk Delete: Select multiple IPs and use **Batch delete**.

<div align="left"><figure><img src="/files/d5RjsEhYJM4MkR28dbX0" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **Country Entry Proxy Access**

① Navigate to:Proxies → Residential Proxies → Proxy Setup →**Endpoint Generator**.

② **Authentication method**: Select **Whitelisted IPs**.

* No whitelist *?* Click 【**Add  Now**】.

③ **Endpoint Type**: Select **Country Entry**.

④ **Location settings**: Choose target Country/Region.

* Refer to the [<mark style="color:blue;">**country/region entry nodes**</mark> ](/doc/proxies/residential-proxies/location-settings/country-region-entry-node.md) for detailed instructions.&#x20;

⑤ **Session settings**:

* **Rotating Session**: Automatically switches IPs with each request (ideal for high anonymity).
* **Sticky Session**: Maintains the same IP for 1-90 minutes (ideal for session continuity).

⑥ **Submit Requests**:

* Add your IP to Thordata's whitelist to bypass per-request credentials
* Once configured, send requests directly through your proxy endpoint

```
curl -x "pr.thordata.net:9999" "https://ipinfo.thordata.com"
```

⑦ **Output Format**:

* System generates proxy strings: `ProxyAddress:ProxyPort`.
* Select **Output Format**, set **Proxy Quantity** and **Connection Protocol**, then **Generate & Activate**.

<div align="left"><figure><img src="/files/hCSICY8yFmzOePqe7vXv" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### **API Link Generation**

① Navigate to **Proxies → Residential Proxies → Endpoint Generator**

② **Authentication**: Select **IP Whitelist**

* No whitelist? Click **AddNow**

③ **Endpoint Type**: Select **API Link**.

④ **Parameter settings**:

* Set IP number    Set country

⑤ **Session settings**:

* **Rotating Session**: Automatically switches IPs with each request (ideal for high anonymity).
* **Sticky Session**: Maintains the same IP for 1-90 minutes (ideal for session continuity).

⑥ **Get Extract API Link**:

* Generate IP List or Copy API Link for integration.

{% hint style="warning" %}
The IPs displayed are system identifiers, not actual exit IPs. Real exit IPs are dynamically assigned during website access based on your port selection and session mode.
{% endhint %}

<figure><img src="/files/JJWlK3SveYqVH32lWIiO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Usage Statistics &#x20;

Navigate to: Proxies → Residential Proxies → **Statistics.**&#x20;

Filter data by: Time Period、Identity Type (Account or IP Whitelist)、Account Level (Master Account or Specific Sub-Account)、Region、Target Domain

<div align="left"><figure><img src="/files/gNKWV6B3qK3gX6XPVS6p" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}