> 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FurD6UqNHglmG59eduIMA%2Fimage.png?alt=media&amp;token=c9bdbed7-8ff2-4b0f-9796-3e365cb8bb28" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FnP12a3agOQhg9u2DYTmY%2Fimage.png?alt=media&amp;token=ece8dc1a-2032-458a-8be0-05d4088ffa71" 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FCbrwC9AwSZrvTB324oBQ%2Fimage.png?alt=media&amp;token=d61c3567-854f-401e-8405-791dbfd91d9d" 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FqhJaCkveoZzf4apseeXq%2Fimage.png?alt=media&amp;token=c6f2aad5-85d1-4d7f-91d4-647a400961f5" alt="" width="375"><figcaption></figcaption></figure></div>

\
② Enter valid IP addresses in the required format.

<div align="left"><figure><img src="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2Fa2Bn2HOuQOxSAadO5PBg%2Fimage.png?alt=media&amp;token=4e03ecca-ce63-4a68-8822-4ec6fe8f7986" 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FPniIJuRuVhMO9hkUBSdO%2Fimage.png?alt=media&amp;token=e0d446a0-3f39-4332-9ec2-a11ca9fc5139" 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2FIzRtPWN650OKvdY9lmPL%2Fimage.png?alt=media&amp;token=68a2ce82-ec3e-462f-b535-1facbbdd1f11" 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2F4Sc5jCweUDFONO56gK6O%2Fimage.png?alt=media&amp;token=8bb12f0c-cbcc-496f-9b93-befb8b513f98" 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="https://340306199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1wQhlaRQzrtcn9wgMUU5%2Fuploads%2Fe1Ip0E7FRLObUYTWuEVx%2Fimage.png?alt=media&amp;token=7902832f-71ec-4d9a-a52f-47f84c280e03" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
