> 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/isp-datacenter-proxies/get-proxy-ip-list.md).

# Get Proxy IP List

### Basic Information

**Interface Description:** Get the list of proxy IPs purchased by Thordata ISP Proxies or Datacenter Proxies through the interface

**Interface URL:** <https://openapi.thordata.com/api/proxy/proxy-list>

**Request Method:** <mark style="color:green;">GET</mark>

### Request parameters

**Params：**

<table><thead><tr><th>Parameter name</th><th>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><tr><td><code>proxy_type</code></td><td>number</td><td>Yes</td><td>Select the proxy type: 1 is ISP Proxies, 2 is Datacenter Proxies (default is 1)</td></tr></tbody></table>

### Response example

```json
{
    "code": 200,
    "data": [
        {
            "purchase_time": "2025-03-06 14:21",
            "expiration_time": "2025-03-13 14:21",
            "ip": "1.1.1.1",
            "port": 6666,
            "username": "user123",
            "password": "password123",
            "country": "US",
            "city": "New York"
        }
    ],
    "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="171">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>purchase_time</code></td><td>string</td><td>Yes</td><td>Purchase time</td></tr><tr><td><code>expiration_time</code></td><td>string</td><td>Yes</td><td>Expiration time</td></tr><tr><td><code>ip</code></td><td>string</td><td>Yes</td><td>IP Information</td></tr><tr><td><code>username</code></td><td>string</td><td>Yes</td><td>Proxy username</td></tr><tr><td><code>password</code></td><td>string</td><td>Yes</td><td>Proxy password</td></tr><tr><td><code>country</code></td><td>string</td><td>Yes</td><td>IP Country</td></tr><tr><td><code>city</code></td><td>string</td><td>Yes</td><td>IP City</td></tr><tr><td><code>msg</code></td><td>string</td><td>No</td><td>-</td></tr></tbody></table>