Extend proxies

This document provides a detailed guide on how to set up automatic renewal for your IP addresses of various types. Please note that IP addresses must be renewed on time to maintain the same addresses.

Calculate extension

This endpoint helps you calculate the cost. Discounts for volume and rental periods are similar to those offered by our service.

Endpoint:

POSThttps://proxy-seller.com/personal/api/v1/{YourApiKey}/prolong/calc/{type}

Path parameters

Name	Value	Description
Authorization	`<Your_API_Key>`	Your personal API key (how to get)
Proxy type	`ipv4` `ipv6` `mobile` `isp` `mix` `mix_isp`	The proxy type you want to extend

Name

Value

Description

Authorization

<Your_API_Key>

Your personal API key (how to get)

Proxy type

ipv4

ipv6

mobile

isp

mix

mix_isp

The proxy type you want to extend

Request body

Name	Type	Description
ids	Number	A single ID or an array of IDs in '[ ]', separated by commas (how to get)
coupon	String	The comment you want to add
periodId	String	ID of the period you selected in the /reference/list/{type} request
paymentId	String	The ID of the payment system. '1' for balance, '43' for the card added to your account.

Example (e.g. ipv4)

https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/prolong/calc/ipv4

Response

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [
      {
        "id": 10,
        "order_id": 1000000,
        "order_number": "1000000_57471911",
        "base_order_number": "1000000_57471911",
        "ip": "127.0.0.1",
        "port_http": 80,
        "port_socks": 443,
        "login": "login",
        "password": "password",
        "auth_ip": "127.0.0.2",
        "country": "USA",
        "date_start": "d.m.Y H:i:s",
        "date_end": "d.m.Y H:i:s",
        "comment": "d.m.Y H:i:s",
        "status": "ACTIVE",
        "rotation": "5",
        "link_reboot": "https://proxy-seller.com/api/proxy/reboot?token=12345",
        "can_prolong": true
      }
    ],
    "orders": 2
  },
  "errors": []
}

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [
      {
        "id": 10,
        "order_id": 1000000,
        "ip": "127.0.0.1",
        "port_http": 80,
        "port_socks": 443,
        "login": "login",
        "password": "password",
        "auth_ip": "127.0.0.2",
        "country": "USA",
        "date_start": "d.m.Y H:i:s",
        "date_end": "d.m.Y H:i:s",
        "comment": "d.m.Y H:i:s",
        "status": "ACTIVE",
        "rotation": "5",
        "link_reboot": "https://proxy-seller.com/api/proxy/reboot?token=12345",
        "can_prolong": true
      }
    ],
    "orders": 2
  },
  "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Set existed [periodId] from reference",
            "code": 0,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not found",
            "code": 0,
            "customData": null
        }
    ]
}

Create a renewal order

In this section you will learn how to create renewal order.

Endpoint:

POSThttps://proxy-seller.com/personal/api/v1/{YourApiKey}/prolong/make/{type}

Path parametrs

Name	Value	Description
Authorization	`<Your_API_Key>`	Your personal API key (how to get)
Proxy type	`ipv4` `ipv6` `mobile` `isp` `mix` `mix_isp`	Proxy type that you want to prolong

Name

Value

Description

Authorization

<Your_API_Key>

Your personal API key (how to get)

Proxy type

ipv4

ipv6

mobile

isp

mix

mix_isp

Proxy type that you want to prolong

Request body

Name	Type	Description
ids	Number	One or array in ids of "[ ]", separated by commas
coupon	String	Comment which you want to add
periodId	String	ID of the period you selected in the /reference/list/{type} request
paymentId	String	Id's of payments system "1" - balance, "43" - card that you added in your cabinet

Example (e.g. ipv4)

https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/prolong/make/ipv4

Response

{
  "status": "success",
  "data": {
        "orderId": 3388536,
        "total": 35.1,
        "listBaseOrderNumbers": [
            "1000000_57471911"
        ],
        "balance": 40.4,
  },
  "errors": []
}

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [
      {
        "id": 10,
        "order_id": 1000000,
        "ip": "127.0.0.1",
        "port_http": 80,
        "port_socks": 443,
        "login": "login",
        "password": "password",
        "auth_ip": "127.0.0.2",
        "country": "USA",
        "date_start": "d.m.Y H:i:s",
        "date_end": "d.m.Y H:i:s",
        "comment": "d.m.Y H:i:s",
        "status": "ACTIVE",
        "rotation": "5",
        "link_reboot": "https://proxy-seller.com/api/proxy/reboot?token=12345",
        "can_prolong": true
      }
    ],
    "orders": 2
  },
  "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Set existed [periodId] from reference",
            "code": 0,
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not found",
            "code": 0,
            "customData": null
        }
    ]
}

Calculate extension

Endpoint:

Path parameters

Request body

Example (e.g. ipv4)

Response

Create a renewal order

Endpoint:

Path parametrs

Request body

Example (e.g. ipv4)

Response

On this page