Want to provide feedback?

Write to docs@telesign.com.

Cancel a Lease

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

DELETE /v1/phone_numbers/leases/3914 HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic pPF9MAXw9ssP0rkk8sbWf18Fny5Vgqi4F1owcHADr8LXk8PMWIvWqeg419NNXmBtMkaTJi3U5IOhOrNOY1ZXdBv3pLZxn08Rah8mMTGv623wYqmmNRcI5adDVnYbm1ejt2E4JCiMmOFahwcNcy844cpz8dTEWMVo1XthlYf=
Host: rest-ww.telesign.com
  "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.

Next Steps

Check out some other related pages:

  • Create a Lease - Learn how to use the Phone Numbers API to lease a specified phone number.
  • List Your Leased Numbers - Learn how to use the Phone Numbers API to retrieve a list of the phone numbers you have leased.