Skip to main content
Retrieves the details of the specified toll-free number from the specified number pool.

​
API Endpoint

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

​
Arguments

No arguments need to be passed.

​
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. 
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)

​
Response

{
    "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"
}