Request

https://smspva.com/api/rent.php?method=getcountries

Response

{
  "status": 1,
  "data": [
    {
      "name": "Россия", // country name
      "code": "RU"      // country code
    }
  ]
}

Request

https://smspva.com/api/rent.php?method=getdata&country=RU

country - country code
dtype - type of period: week or month
dcount - count type of period, i.e. if dtype=week then counts of weeks

Response

{
  "status": 1,
  "data": [
    {
      "name": "Airbnb",   // service name
      "service": "opt46", // service code
      "price_day": 6,     // price per day
      "count": 359        // available count
    }
  ]
}

Request

https://smspva.com/api/rent.php?method=create&apikey=yourapikeyhere&dtype=week&dcount=1&country=RU&service=opt6

dtype - type of period: week or month
dcount - count type of period, i.e. if dtype=week then counts of weeks
country - country code of number
service - service code

Response

{
  "status": 1,
  "data": {
    "id": 40370,             // ID of order
    "pnumber": "9096037108", // phone number without country code
    "ccode": "+7",           // digital country code
    "service": "opt6",       // service code
    "until": 1587633960      // UNIX timestamp of expire date
  }
}

Request

https://smspva.com/api/rent.php?method=orders&apikey=yourapikeyhere

Response

{
  "status": 1,
  "data": [
    {
      "id": 40300,              // ID of order
      "scode": "opt16",         // service code
      "sname": "Instagram",     // service name
      "state": 0,               // state of number
                                // 0 - not active, need to activate before send SMS
                                // 1 - active, can receive SMS
                                // 2 - activating process
                                // -1 - phone number not in the system
      "pnumber": "9096068511",  // phone number without country code
      "ccode": "+7",            // digital country code
      "cname": "RU",            // country code
      "hasnewsms": false,       // flag of new SMS
      "until": 1587552240,      // UNIX timestamp of expire date
      "canprolong": true,       // flag of availablity of prolongation
      "canprolongmax": 162,     // max days for prolongation
      "canprolonguntil": 1634883780 // Unix timestamp for max prolongation
      "lastonline": 1586947920  // Unix timestamp of last online date of number
    }
  ]
}

Request

https://smspva.com/api/rent.php?method=add_service_to_order&apikey=yourapikeyhere&id=3****4&service=opt89&pnumber=79*******95

apikey - Your API-key
id - ID of the rental order
service - service code
pnumber - rented phone number with country code without "+"

Response

{
  "status": 1
}

Request

https://smspva.com/api/rent.php?method=sms&id=123&apikey=yourapikeyhere

id - ID of order

Response

{
  "status": 1,
  "data": [
    {
      "text": "Code Instagram: 671 094.", // text of SMS
      "sender": "FACEBOOK", // sender of the SMS
      "date": 1586948100 // Unix timestamp of receiving date
    }
  ]
}

Request

https://smspva.com/api/rent.php?id=123&dcount=1&dtype=week&method=prolong&apikey=yourapikeyhere

id - ID of order
dtype - type of period: week or month
dcount - count type of period, i.e. if dtype=week then counts of weeks

Response

{
  "status": 1,
  "data": {
    "id": 123 // ID of order
  }
}

Request

https://smspva.com/api/rent.php?method=activate&id=123&apikey=yourapikeyhere

id - ID of order

Response

{
  "status": 1,
  "data": {
    "id": 123 // ID of order
  }
}

Request

https://smspva.com/api/rent.php?method=delete&id=123&apikey=yourapikeyhere

id - ID of order

Response

{
  "status": 1,
  "data": {
    "id": 123 // ID of order
  }
}

To restore the lease agreement, you need to get the order ID. To get a list of orders with the necessary information from the archive, you can request

Request

https://smspva.com/api/rent.php?method=get_rent_history&apikey=userKey&skip=skipArchive&take=takeArchive

userKey - User Key
skipArchive - Number of items to skip
takeArchive - Number of items received

We will get a response in the form of JSON

{ 
    "status": 1,
    "data": [{
                "orderId":517017,"resourceCode":"opt59","number":"79020831944",
                "branchId":1235,"haveSms":true,"days":7,"country":"EN",
                "begin":1222222231,"end":1611111931,"closed":1632445144
            }]
}

After receiving the ID of the desired reservation, you need to make another request to check the availability of the for rent`s and calculate the cost of restoration.

Request

    https://smspva.com/api/rent.php?method=restore_user_precalc&apikey=userKey&id= orderId

    userKey - User key
    orderId - ID of the rental order

Response

{
    "status": 1,
    "data": {
        "ccode": "EN",
        "scode": "opt59",
        "price": 2.4,
        "sname": "Avito",
        "pnumber": "79929831844",
        "outdays": 32,
        "orderid": 317017,
        "prolongTo": 30
    }
}

If an exception occurs, we will receive a status with the value "0" and an error message in the msg field. at the bottom of the instructions is a list of possible exceptions and their description

After receiving a positive response and agreeing to the terms of the lease restoration, you can make a last request that will return the rental number

Request

https://smspva.com/api/rent.php?method=restore_user&apikey=userKey&id=orderId

userKey - User key
orderId - ID of the rental order

Response

{"status":1,"data":true}

The request will return an object with status and data fields, if the values are positive, then the number has been restored. If the values are not positive, double-check the data and try again, if this also did not help, contact the site support service

Possible errors in the request https://smspva.com/api/rent.php?method=restore_user