List address
An Address instance resource represents your or your customer's physical location within a country. Around the world, some local authorities require the name and address of the user to be on file with Twilio to purchase and own a phone number.
Path parameters
-
The SID of the Account that is responsible for the Address resource to read.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^AC[0-9a-fA-F]{32}$
.
Query parameters
-
The
customer_name
of the Address resources to read. -
The string that identifies the Address resources to read.
-
Whether the address can be associated to a number for emergency calling.
-
The ISO country code of the Address resources to read.
-
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
. -
The page index. This value is simply for client state.
Minimum value is
0
. -
The page token. This is provided by the API.
curl \
--request GET 'https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses.json' \
--user "username:password"
{
"end": 0,
"uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Addresses.json?FriendlyName=friendly_name&IsoCountry=US&CustomerName=customer_name&PageSize=50&Page=0",
"page": 0,
"start": 0,
"addresses": [
{
"sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Addresses/ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
"city": "SF",
"region": "CA",
"street": "4th",
"verified": false,
"validated": false,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"iso_country": "US",
"postal_code": "94019",
"date_created": "Tue, 18 Aug 2015 17:07:30 +0000",
"date_updated": "Tue, 18 Aug 2015 17:07:30 +0000",
"customer_name": "name",
"friendly_name": "Main Office",
"street_secondary": null,
"emergency_enabled": false
}
],
"page_size": 50,
"next_page_uri": null,
"first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Addresses.json?FriendlyName=friendly_name&IsoCountry=US&CustomerName=customer_name&PageSize=50&Page=0",
"previous_page_uri": null
}
{
"end": 0,
"uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Addresses.json?FriendlyName=friendly_name&IsoCountry=US&CustomerName=customer_name&PageSize=50&Page=0",
"page": 0,
"start": 0,
"addresses": [],
"page_size": 50,
"next_page_uri": null,
"first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Addresses.json?FriendlyName=friendly_name&IsoCountry=US&CustomerName=customer_name&PageSize=50&Page=0",
"previous_page_uri": null
}