# IP replacement

This endpoint allows you to automate IP replacement requests. Please note that processing the request may take some time.

{% hint style="info" %}
You can request IP replacement for a single proxy once per day.
{% endhint %}

### **Endpoint:**

<mark style="color:yellow;">`POST`</mark> `https://proxy-seller.com/personal/api/v1/`**`{YourApiKey}`**`/proxy/replace`

#### **Example**

```
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/proxy/replace
```

### **Response**

{% tabs %}
{% tab title="200: OK Success response" %}

```json
{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "31.6.33.97"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}
```

{% endtab %}

{% tab title="200: OK Error response " %}
**wrong API key**

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response " %}
**incorrect type**

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "code": 0,
            "customData": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Path parameters

<table data-full-width="false"><thead><tr><th width="149">Name</th><th width="259">Value</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Authorization</td><td><code>&#x3C;Your_API_Key></code></td><td>Your personal API key (<a href="../../authorization#get-your-api-keys">how to get</a>)</td><td></td></tr></tbody></table>

### **Request body**

<table><thead><tr><th width="139">Name</th><th width="134">Type</th><th>Description</th></tr></thead><tbody><tr><td>ids</td><td>Number</td><td>A single ID or an array of IDs in '[ ]', separated by commas</td></tr><tr><td>comment</td><td>String</td><td>Optional comment to include with the request</td></tr><tr><td>type</td><td>String</td><td>Type of replacement</td></tr></tbody></table>

{% hint style="info" %}
Types of replacement: NOT\_WORK, INCORRECT\_LOCATION, CANT\_CHANGE\_NETWORK, LOW\_SPEED, CUSTOM
{% endhint %}