Mobile requests

To get the list of available mobile tariffs

GET /client-api/v1/<apiKey>/get/tariffs

Example body answer:

{
    "success":true,
    "user":"[email protected]",
    "balance":13.09,
    "currency":"USD",
    "tariffs":[
               {
                "country":"GBR",
                "mobileOperator":[
                                  {
                                   "name":"Three",
                                   "rotationTime":[
                                                   0,
                                                   5,
                                                   10
                                                  ]
                                  },
                                  {
                                   "name":"O2",
                                   "rotationTime":[
                                                   5,
                                                   10
                                                  ]
                                  }
                                 ]
               },
               {
                "country":"USA",
                "mobileOperator":[
                                  {
                                   "name":"AT&T Wireless",
                                   "rotationTime":[
                                                   0,
                                                   5,
                                                   10
                                                  ]
                                  }
                                 ]
               }
              ]
}

Response params:

• "tariffs" — the list of tariffs,

• "country" — alfa3 country code,

• "mobileOperator" — the list of available operators for this country,

• "rotationTime" — available rotation times of IP address in minutes. 0 is rotation by link at any moment.

---

To get the list of active mobile proxies

GET /client-api/v1/<apiKey>/get/proxies

Request parameters:

"proxyType" — type of proxy — "mobile".

Example request:

/client-api/v1/<apiKey>/get/proxies?proxyType=mobile

Example body answer:

{
    "success":true,
    "user":"[email protected]",
    "balance":13.09,
    "currency":"USD",
    "proxyType":"mobile",
    "countOfProxy":2,
    "proxies":[
               {
                "id":"id1",
                "ip":"61.62.63.64",
                "country":"FRA",
                "dateStart":"2022-08-30T14:54:25.414+00:00",
                "dateEnd":"2022-09-29T23:59:25.414+00:00",
                "httpsPort":"7781",
                "socks5Port":"8891",
                "mobileOperator":"freemobilesas_france",
                "rotationTime":0,
                "rebootLink":"https://proxy-ipv4.com/modem/reboot/448eac96-8546-4389-8f56-54b2sb4798d12",
                "authInfo":{
                            "login":"authLogin123",
                            "password":"authPassword"
                           }
               },
               {
                "id":"id2",
                "ip":"61.62.63.64",
                "country":"FRA",
                "dateStart":"2022-08-30T14:54:25.414+00:00",
                "dateEnd":"2022-09-29T23:59:25.414+00:00",
                "httpsPort":"7782",
                "socks5Port":"8892",
                "mobileOperator":"freemobilesas_france",
                "rotationTime":0,
                "rebootLink":"https://proxy-ipv4.com/modem/reboot/44cf7d39-b682-4296-8909-7038ba99008b5",
                "authInfo":{
                            "login":"authLogin123",
                            "password":"authPassword"
                           }
               }
              ]
}

Response params:

• "proxies" — the list of active proxies,

• "id" — proxy ID. This parameter is needed for extending proxy,

• "country" — alfa3 country code,

• "dateStart" — the rent start date,

• "dateEnd" — the rent end date,

• "rotationTime" — the rotation time of IP address in minutes. 0 is rotation by link at any moment,

• "rebootLink" — the link for rotation IP,

• "authInfo" — the data for authorization.

---

Calculate purchase price

GET /client-api/v1/<apiKey>/get/order/price

Request parameters:

• "proxyType" — type of proxy — "mobile",

• "days" — the number of rental days (available values can be obtained through other request),

• "goal" — goal of using proxy (available values can be obtained through other request),

• "customGoal" — if the goal that you need isn't present in the goal list, you can indicate your own goal. Length of the field must be 5 characters or more (one of the parameters — goal or customGoal — must be in the request),

• "country" — alfa3 country code (available values can be obtained through other request),

• "count" — the number of proxies,

• "mobileOperator" — the mobile operator (available values can be obtained through other request),

• "rotationTime" — the rotation time of IP address in minutes (available values can be obtained through other request).

Example request:

/client-api/v1/<apiKey>/get/order/price?proxyType=mobile&days=7&goal=instagram&country=FRA&count=1&mobileOperator=freemobilesas_france&rotationTime=5

Example body answer:

{
    "success":true,
    "user":"[email protected]",
    "balance":13.09,
    "currency":"USD",
    "proxyType":"mobile",
    "rotationTime":5,
    "mobileOperator":"freemobilesas_france",
    "days":7,
    "count":1,
    "goal":"instagram",
    "amount":1.78,
    "price":1.78
}

Response params:

• "amount" — total amount,

• "price" — price for one proxy.

---

Calculate extending price

GET /client-api/v1/<apiKey>/get/extend/price

Request parameters:

• "proxyType" — type of proxy — "mobile",

• "days" — the number of renewal days (the available values are the same as for the purchase),

• "IpId" — proxy IDs that require renewal (it is allowed to indicate several IDs separated by commas).

Example request:

/client-api/v1/<apiKey>/get/extend/price?proxyType=mobile&days=7&IpId=id1,id2,id3

Example body answer:

{
    "success":true,
    "user":"[email protected]",
    "balance":13.09,
    "currency":"USD",
    "proxyType":"mobile",
    "days":7,
    "count":3,
    "amount":9.13,
    "price":3.04,
    "ipId":[
            "id1",
            "id2",
            "id3"
           ]
}

Response params:

• "amount" — total amount,

• "price" — price for extending one proxy,

• "ipId" — the list of proxy IDs for extending.

---

Placing an order

POST /client-api/v1/<apiKey>/order

Request parameters:

• "proxyType" — type of proxy — "mobile",

• "days" — the number of rental days (available values can be obtained through other request),

• "goal" — goal of using proxy,

• "country" — alfa3 country code,

• "count" — the number of proxies,

• "authType" — authorization type — "login/ip",

• "authIp" — authorization IP address. This field is required only if authType = ip,

• "mobileOperator" — the mobile operator (available values can be obtained through other request),

• "rotationTime" — the rotation time of IP address in minutes (available values can be obtained through other request).

Example request:

/client-api/v1/<apiKey>/order

Example body request:

{
    "proxyType":"mobile",
    "days":30,
    "goal":"instagram",
    "country":"FRA",
    "count":1,
    "authType":"login",
    "mobileOperator":"freemobilesas_france",
    "rotationTime":5
}

Example body answer:

{
    "success":true,
    "user":"[email protected]",
    "balance":4.09,
    "currency":"USD",
    "proxyType":"mobile",
    "orderNumber":"DV-21x1552356-jA"
}

Response params:

• "orderNumber" — order number,

• "balance" — the balance after the purchase.

---

Extending proxy

POST /client-api/v1/<apiKey>/extend

Request parameters:

• "proxyType" — type of proxy — "mobile",

• "days" — the number of renewal days (the available values are the same as for the purchase),

• "IpId" — the list of proxy IDs to be extended.

Example request:

/client-api/v1/<apiKey>/extend

Example body request:

{
    "proxyType":"mobile",
    "days":30,
    "IpId":[
            "id1",
            "id2"
           ]
}

Example body answer:

{
    "success":true,
    "user":"[email protected]",
    "balance":4.09,
    "currency":"USD"
}

Response params:

"balance" — the balance after extending.