# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/proxies/residential-proxies/whitelisted-ips.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
