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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proxy-seller.com/proxy-seller/order-actions/place-an-order.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.