> 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

Configure and manage whitelisted IP access for Thordata Residential Proxies, including endpoint generation, location targeting, session settings, API links, and usage statistics.

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