> ## 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.

# Retrieve a toll-free number

> Fetch details of a toll-free number from a number pool

Retrieves the details of the specified toll-free number from the specified number pool.

#### API Endpoint

```text GET theme={null}
https://api.plivo.com/v1/Account/{auth_id}/NumberPool/{number_pool_uuid}/Tollfree/{toll_free_number}/</code></div>
```

### Arguments

<Note>
  No arguments need to be passed.
</Note>

### Returns

This API call returns the details for the toll-free number identified by the `toll_free_number` and `number_pool_uuid` specified in the request URL.

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

  client = plivo.RestClient(auth_id="<auth_id>", auth_token="<auth_token>")
  # Retrieve a Specific Tollfree Number
  powerpack = client.powerpacks.get(uuid='<powerpack_uuid>')
  # Version 1
  response = powerpack.find_tollfree('<tollfree_number>')
  # Version 2
  response = powerpack.numberpool.tollfree.find('<tollfree_number>')
  print(response)
  ```

  ```ruby Ruby theme={null}
  require 'rubygems'
  require 'plivo'

  include Plivo
  include Plivo::Exceptions

  api = RestClient.new("<auth_id>", "<auth_token>")

  begin
  # Retrieve a Specific Tollfree Number
  powerpack = api.powerpacks.get('<powerpack_uuid>')
  # Version 1
  response = powerpack.find_tollfree('<tollfree_number>') 
  # Version 2
  response = powerpack.numberpool.tollfree.find('<tollfree_number>')

  puts(response)
  rescue PlivoRESTError => e
  puts 'Exception: ' + e.message
  end
  ```

  ```js Node theme={null}
  let plivo = require('plivo');

  let client = new plivo.Client('<auth_id>', '<auth_token>');

  // Retrieve a Specific Tollfree Number
  client.powerpacks.get("<powerpack_uuid>").then(
    function (powerpack) {
      return powerpack.find_tollfree("<tollfree>")
      // return powerpack.number_pool.tollfree.find("<tollfree>"); V2
    })
  .then(function (result) {
    console.log(result)
  })
  ```

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

  $client = new RestClient("<auth_id>", "<auth_token>");
  $client->client->setTimeout(40);

  // Retrieve a Specific Tollfree Number
      try {
      $powerpack = $client->powerpacks->get("<powerpack_uuid>");
      // Version 1
      $response = $powerpack->find_tollfree('<tollfree_number>');
      // Version 2
      $response = $powerpack->number_pool->tollfree->find('<tollfree_number>');
      print_r($response);
      } 
      catch (PlivoRestException $ex) {
          print_r($ex);
      }
  ```

  ```java Java theme={null}
  ```

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

  namespace PlivoExamples
  {
      class Program
      {
          static void Main(string[] args)
          {
              var api = new PlivoApi("<auth_id>","<auth_token>");

              // Retrieve a Specific Tollfree Number
              try
              {   
                  var powerpack = api.Powerpacks.Get("<poerpack_uuid>");
                  // Version 1
                  var response = powerpack.Find_Tollfree("<tollfree_number>");
                  // Version 2
                  var response = powerpack.numberpool.tollfree.Find("<tollfree_number>");
                  Console.WriteLine(response);
              }
              catch (PlivoRestException e)
              {
                  Console.WriteLine("Exception: " + e.Message);
              }
          }
      }
  }
  ```

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

  import (
  	"fmt"

  	plivo "github.com/plivo/plivo-go/v7"
  )

  func main() {

  	client, err := plivo.NewClient("<auth_id>", "<auth_token>",
  		&plivo.ClientOptions{})
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}

  	// Retrieve a Specific Tollfree Number
  	powerpack, err := client.Powerpack.Get("<powerpack_uuid>")
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	response, err := powerpack.Find_tollfree("<tollfree_number>")
  	if err != nil {
  		fmt.Print("Error", err.Error())
  		return
  	}
  	fmt.Printf("Response: %#v\n", response)
  }
  ```

  ```sh cURL theme={null}
  ```
</RequestExample>

### Response

```json theme={null}
{
    "account_phone_number_resource": "/v1/Account/{auth_id}/Number/{your_toll_free_number}/",
    "added_on": "2023-03-18T16:07:39.379739Z",
    "api_id": "df0519d6-7ed4-11ea-b82e-0242ac110006",
    "country_iso2": "US",
    "number": "{your_toll_free_number}",
    "number_pool_uuid": "{number_pool_uuid}",
    "type": "tollfree"
}
```