Tropo is part of CiscoLearn More

Addresses (Phone numbers)

An address represents a phone number, SIP address, or API token in Tropo.

The addresses resource allows you to view and manage addresses in your applications.

Resource URL

https://api.tropo.com/v1/applications/:id/addresses/

Fields

type
This defines the type of address. The possible types are number, token, and sip.
prefix
This defines the country code and area code for a phone number. This field will not display if you use a GET on a particular address, it's only relevant when requesting a auto-provisioned phone number. If the type parameter is set to 'number', you need to include either a value for this parameter or for number.
number
This is used when you want to assign a specific phone number to an application rather than request one based on prefix. See the Adding a Specific Number tutorial for more details. If the type parameter is set to 'number', you need to include either a value for this parameter or for prefix.
city
If you run a GET on the addresses associated with your application, this will display the city associated with an already assigned phone number. This field is read-only.
state
If you run a GET on the addresses associated with your application, this will display the state associated with an already assigned phone number. This field is read-only.
channel
This applies only to tokens and identifies the type of channel used by the token. It can be either "voice" or "messaging". This field is only required to be set if you add a token manually (this is rare), otherwise it will just display when you use a GET on an account.
token
This is a long, alphanumeric string that identifies your Tropo app. It's used when you need the application to launch an outbound call based on an external event, like when a user clicks on a link on a web site. Tropo will automatically add tokens to your applications when you create them. You can manually manage tokens, but it's not commonly needed to do so.
capability
An array of the capabilities of this number. Only set on phone numbers, the capabilities (voice, sms, or both) for the number. Numbers that have "SMS" capability can send and receive text messages. Numbers with "voice" can receive calls. Example: "capabilities":["voice", "sms"]