> ## Documentation Index
> Fetch the complete documentation index at: https://plivo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove a number

> Remove a phone number from a Powerpack number pool

Removes a number from a number pool.

#### API Endpoint

```text DELETE theme={null}
https://api.plivo.com/v1/Account/{auth_id}/NumberPool/{number_pool_uuid}/Number/{number}/
```

### Arguments

<table><tbody><tr><td><strong>unrent<br />boolean</strong></td><td>Default is `false` if not specified.</td></tr></tbody></table>

### Returns

This API call removes a number from a number pool identified by the `number` and `number_pool_uuid` specified in the request URL.

<RequestExample>
  ```py Python theme={null}
  import plivo
  import json

  client = plivo.RestClient('<auth_id>','<auth_token>')
  powerpack = client.powerpacks.get(uuid="powerpack_uuid")
  print str(powerpack.remove_number('your-number'))
  ```

  ```ruby Ruby theme={null}
  require 'rubygems'
  require 'plivo'
  include Plivo
  include Plivo::Exceptions

  api = RestClient.new("<auth_id>","<auth_token>")
  begin
    powerpack = api.powerpacks.get(uuid='powerpack_uuid')
    puts powerpack
    response = powerpack.remove_number(number='your_number',unrent= true)
    puts response
  rescue PlivoRESTError => e
    puts 'Exception: ' + e.message
  end
  ```

  ```js Node theme={null}
  var plivo = require('plivo');
  var client = new plivo.Client("<auth_id>","<auth_token>");

  client.powerpacks.get("powerpack_uuid").then(
      function (powerpack) {
        return powerpack.remove_number(
         "<your_number>", true
        )
      })
    .then(function (result) {
      console.log(result)
    })
    .catch(function (response) {
      console.log(response);
    });
  ```

  ```php PHP theme={null}
  <?php
  require 'vendor/autoload.php';
  use Plivo\RestClient;

  $client = new RestClient("<auth_id>","<auth_token>");
  $client->client->setTimeout(40);
  try {
      $powerpack = $client->powerpacks->get("your-powerpack-uuid");
      $response = $powerpack->remove_number('your_number',['unrent'=>true]);
      print_r($response);
  }
  catch (PlivoRestException $ex) {
      print_r($ex);
  }
  ```

  ```java Java theme={null}
  package com.plivo.api;

  import com.plivo.api.models.powerpack.Numbers;
  import com.plivo.api.models.powerpack.Powerpack;
  import com.plivo.api.exceptions.PlivoRestException;

  import java.io.IOException;

  public class PowerpackTest {
    public static void main(String[] args) {
      Plivo.init("<auth_id>", "<auth_token>");
      try {
          Powerpack powerpack = Powerpack.getter("powerpack_uuid").get();
          powerpack.remove_number().number("<your_number>").delete();
      }
      catch (  PlivoRestException | IOException e ) {
          e.printStackTrace();
      }
    }
  }
  ```

  ```csharp .NET theme={null}
  using System;
  using Plivo;
  using Plivo.Exception;
  using System.Collections.Generic;

  namespace test_apps
  {
      class Program
      {
          static void Main(string[] args)
          {
              var api = new PlivoApi("<auth_id>","<auth_token>");
              try
              {
                  var response = api.Powerpacks.Get("powerpack_uuid");
                  Console.WriteLine(response.Remove_Number("<your_number>"));
              }
              catch (PlivoRestException e)
              {
                  Console.WriteLine("Exception: " + e.Message);
              }
          }
      }
  }
  ```

  ```go Go theme={null}
  package main

  import (
  	"fmt"

  	plivo "github.com/plivo/plivo-go/v7"
  )
  s
  func main() {

  	client, err := plivo.NewClient("<auth_id>","<auth_token>", &plivo.ClientOptions{})
  	if err != nil {
  			fmt.Print("Error", err.Error())
  			return
  		}
  	powerpack, err := client.Powerpack.Get("<powerpack_uuid>")
  	if err != nil {
  			fmt.Print("Error", err.Error())
  			return
  		}
  	// Remove a Number
  	response, err := powerpack.Remove_number("<your_number>", {
          Unrent: true,
  	})
  	fmt.Printf("Response: %#v\n", response)
  }
  ```

  ```sh cURL theme={null}
  curl -X DELETE -i --user auth_id:auth_token \
  -H "Content-Type: application/json" \
  https://api.plivo.com/v1/Account/{auth_id}/NumberPool/{number_pool_uuid}/Number/{number}
  ```
</RequestExample>

### Response

```json theme={null}
{
    "api_id": "c378d44c-0a89-11ea-b072-0242ac110007",
    "response": "success"
}
```