> 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/query-proxy-ip-expiration-time.md).

# Query Proxy IP Expiration Time

### Basic Information

**Interface Description:** Query the IP expiration time of Thordata ISP Proxies or Datacenter Proxies through the interface

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

**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><tr><td><code>ips</code></td><td>string</td><td>Yes</td><td>The IP addresses to be queried, separate multiple IP addresses with commas (,)</td></tr></tbody></table>

### Response example

```json
{
    "code": 200,
    "data": [
        {
            "ip": "1.1.1.1",
            "expiration_time": "2025-03-13 14:21"
        }
    ],
    "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>ip</code></td><td>string</td><td>Yes</td><td>IP Information</td></tr><tr><td><code>expiration_time</code></td><td>string</td><td>Yes</td><td>IP expiration time</td></tr><tr><td><code>msg</code></td><td>string</td><td>No</td><td>-</td></tr></tbody></table>