Write to firstname.lastname@example.org.
Search for a Phone Number to Lease
If you want to use a specific caller or sender ID for your messages or use inbound SMS, you must lease a phone number from TeleSign. The
https://rest-ww.telesign.com/phone_numbers/numbers endpoint can be used to review phone numbers and choose the one that suits your needs.
If you have your credentials and access to the Phone Numbers API, you can try a test request in the Phone Numbers API Explorer below. You can also get a code snippet for the request.
The Phone Numbers API Explorer is set up in the above example to search for phone numbers in the United States that are SMS capable. To add your credentials and see the request run, do the following:
- Click the Auth [basic] tab and for Username add your customer ID. For Password add your API key.
- Click the Query tab to see the fields you need to fill out. For this example,
country_iso2is populated with US and
sms_capableis selected to filter numbers with.
sms_capableis set to true, so the response will return US phone numbers that are SMS capable. (See more available parameters on the API reference page - GET v1/numbers.)
- Click Send.
- Click the Code Generation tab and use the Language and Library drop-downs to choose the language you want your code snippet in.
You can see more about available parameters for requests on the GET /numbers page.
This section provides general information about the
/numbers endpoint of the Phone Numbers API.
- The URI is
- You can authenticate with Basic (easiest to implement) and Digest
- Accept only UTF-8 encoded unicode characters as inputs
- Use Content-Type - application/x-www-form-urlencoded in request headers
This section offers some suggestions for next steps to take.
- Review available parameters for your request on the GET /numbers page.
- Create a Lease - Learn how to use the Phone Numbers API to lease a phone number after you search for the one you want.
- Retrieve a List of Your Leased Numbers - Learn how to use the Phone Numbers API to retrieve a list of phone numbers you already leased from TeleSign.