# Place an order

This request helps you place an order.

{% hint style="info" %}
The proxy identifiers change after manual or automatic renewals.

Order processing, selection, and activation of IPs take anywhere from a few seconds to a minute, depending on the system’s overall load, including simultaneous orders and the connection queue.
{% endhint %}

### **Endpoint**:

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

#### **Example**

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

### **Response**

{% tabs %}
{% tab title="200: OK Success response " %}
```json
{
    "status": "success",
    "data": {
        "orderId": 2426273,
        "total": 16.2,
        "listBaseOrderNumbers": [
            "3388485_57471911"
        ],
        "balance": 1776.88
    },
    "errors": []
}
```
{% endtab %}

{% tab title="200: OK Error response" %}
```json
{
  "status": "error",
  "data": null,
  "errors": [
    {
      "message": "Insufficient funds. Total $2. Not enough $33.10",
      "code": 0,
      "customData": null
    }
  ]
}
```
{% endtab %}

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

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Country not exists",
            "code": 0,
            "customData": null
        }
    ]
}
```
{% endtab %}

{% tab title="200: Wrong periodId" %}
**wrong periodId**

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Set existed [periodId] from reference",
            "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**

{% tabs %}
{% tab title="IPv4/ISP/MIX/MIX ISP" %}
<table><thead><tr><th width="192">Name</th><th width="94">Type</th><th>Description</th></tr></thead><tbody><tr><td>countryId</td><td>Number</td><td>ID of the country you selected in the <a href="complete-information">/reference/list/{type}</a> request</td></tr><tr><td>periodId</td><td>String</td><td>ID of the period you selected in the <a href="complete-information">/reference/list/{type}</a>  request</td></tr><tr><td>coupon</td><td>String</td><td>The coupon code, if available</td></tr><tr><td>paymentId</td><td>Number</td><td>IDs of the payment system. '<strong>1</strong>' for balance, '<strong>43</strong>' for the card added to your account</td></tr><tr><td>quantity</td><td>Number</td><td>The number of proxies you want to order</td></tr><tr><td>authorization</td><td>String</td><td>The method of authorization. Leave blank if you want to use username and password for authorization</td></tr><tr><td>customTargetName</td><td>String</td><td>If you want to add a custom goal</td></tr><tr><td><a href="../actions-with-proxies/authorizations">generateAuth</a></td><td>String</td><td>Create <a href="../actions-with-proxies/authorizations/create-authorization">custom authorization</a> - Y/<strong>N</strong> (<strong>N</strong> - default)</td></tr></tbody></table>
{% endtab %}

{% tab title="IPv6" %}


<table><thead><tr><th width="192">Name</th><th width="94">Type</th><th>Description</th></tr></thead><tbody><tr><td>countryId</td><td>Number</td><td>ID of the country you selected in the <a href="complete-information">/reference/list/{type}</a> request</td></tr><tr><td>periodId</td><td>String</td><td>ID of the period you selected in the <a href="complete-information">/reference/list/{type}</a>  request</td></tr><tr><td>coupon</td><td>String</td><td>The coupon code, if available</td></tr><tr><td>paymentId</td><td>Number</td><td>IDs of the payment system. '<strong>1</strong>' for balance, '<strong>43</strong>' for the card added to your account</td></tr><tr><td>quantity</td><td>Number</td><td>The number of proxies you want to order</td></tr><tr><td>authorization</td><td>String</td><td>The method of authorization. Leave blank if you want to use username and password for authorization</td></tr><tr><td>customTargetName</td><td>String</td><td>If you want to add a custom goal</td></tr><tr><td>protocol</td><td>String</td><td><strong>HTTPS</strong> or <strong>SOCKS5</strong></td></tr></tbody></table>
{% endtab %}

{% tab title="Mobile" %}
<table><thead><tr><th width="192">Name</th><th width="94">Type</th><th>Description</th></tr></thead><tbody><tr><td>countryId</td><td>Number</td><td>ID of the country you selected in the <a href="complete-information">/reference/list/{type}</a> request</td></tr><tr><td>periodId</td><td>String</td><td>ID of the period you selected in the <a href="complete-information">/reference/list/{type}</a>  request</td></tr><tr><td>coupon</td><td>String</td><td>The coupon code, if available</td></tr><tr><td>paymentId</td><td>Number</td><td>IDs of the payment system. '<strong>1</strong>' for balance, '<strong>43</strong>' for the card added to your account</td></tr><tr><td>quantity</td><td>Number</td><td>The number of proxies you want to order</td></tr><tr><td>authorization</td><td>String</td><td>The method of authorization. Leave blank if you want to use username and password for authorization</td></tr><tr><td>mobileServiceType</td><td>String</td><td><strong>shared</strong> or <strong>dedicated</strong></td></tr><tr><td>operatorId</td><td>String</td><td>ID of the operator you selected in the <a href="complete-information">/reference/list/{type}</a> request</td></tr><tr><td>rotationId</td><td>Number</td><td>ID of the rotation you selected in the <a href="complete-information">/reference/list/{type}</a> request</td></tr></tbody></table>
{% endtab %}

{% tab title="Resident" %}
<table><thead><tr><th width="192">Name</th><th width="94">Type</th><th>Description</th></tr></thead><tbody><tr><td>coupon</td><td>String</td><td>The coupon code, if available</td></tr><tr><td>paymentId</td><td>Number</td><td>IDs of the payment system. '<strong>1</strong>' for balance, '<strong>43</strong>' for the card added to your account</td></tr><tr><td>tarifId</td><td>Number</td><td>ID of the tarid you selected in the <a href="complete-information">/reference/list/{type}</a> request</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

