Phone Numbers API - Cancel a Lease

If you no longer need a phone number you have leased through TeleSign, use this method to cancel your lease.

Reference Page

DELETE /v1/phone_numbers/leases/{lease_id}

Request

DELETE /v1/phone_numbers/leases/3914 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic pPF9MAXw9ssP0rkk8sbWf18Fny5Vgqi4F1owcHADr8LXk8PMWIvWqeg419NNXmBtMkaTJi3U5IOhOrNOY1ZXdBv3pLZxn08Rah8mMTGv623wYqmmNRcI5adDVnYbm1ejt2E4JCiMmOFahwcNcy844cpz8dTEWMVo1XthlYf=
Host: rest-ww.telesign.com

Response

{
  "data": [
    {
      "phone_number": "12133202170",
      "recurring_price": 0.8,
      "number_type": "local",
      "setup_price": 0.8,
      "price_currency": "USD",
      "country_iso2": "US",
      "lease": {
        "lease_id": 3914,
        "created_on_utc": "2019-10-21T17:37:01.260000Z",
        "expires_on_utc": null
      },
      "capabilities": {
        "sms": true,
        "voice": true
      },
      "recurrence_period": 1
    }
  ]
}

Billing and Pricing

After successfully cancelling a lease using this method, you will still be billed for it to the end of your current billing period, but then not for any future periods.