Get Started with Account Phone Numbers
These actions can be performed with the Number API:
- List All Rented Numbers
- Get Details of a Rented Number
- Edit a Number
- Link an Application to a Number
- Unlink an Application from a Number
- Relinquish a Number
BaseURI
https://api.plivo.com/v1/Account/{auth_id}/Number/
Prerequisites
- Sign up for a free Plivo trial account.
- Check out our server SDKs and install the SDK for the programming language you want to use.
- Buy a Plivo phone number. You need a Plivo phone number to receive calls. You can buy a Plivo phone number in more than 20 countries by visiting Phone Numbers > Buy Numbers in the Plivo console. Check the Voice API coverage page to see the supported countries.
- Use a web hosting service to host your web application. Many inexpensive cloud hosting providers charge just a few dollars a month. Follow the instructions of your hosting provider to host your web application.
List all rented numbers
This API call returns a list with the details of all numbers rented under your Plivo account.
GET
https://api.plivo.com/v1/Account/{auth_id}/Number/
Code
Get details of a rented number
This API call returns the details of a single number rented under your Plivo account.
GET
https://api.plivo.com/v1/Account/{auth_id}/Number/{number}/
Code
Edit a number
This API call lets you change the application and subaccount associated with a number you rented.
POST
https://api.plivo.com/v1/Account/{auth_id}/Number/{number}/
Code
Link an application to a number
This API call lets you link an application to a number you rented.
POST
https://api.plivo.com/v1/Account/{auth_id}/Number/{number}/
Code
Unlink an application from a number
This API call lets you unlink an application from a number you rented.
POST
https://api.plivo.com/v1/Account/{auth_id}/Number/{number}/
Code
Relinquish a number
This API lets you relinquish a number on Plivo. Upon successful execution, the number will no longer be usable or accessible from your Plivo account. This operation cannot be undone.
DELETE
https://api.plivo.com/v1/Account/{auth_id}/Number/{number}/
Code
Next step
Learn how to Search and Rent Phone Numbers.