Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/Addresses.json

List account addresses

Lists Address resources associated with an Account. Use the available filters to narrow results by customer, friendly name, emergency-calling capability, or ISO country code, and use the pagination parameters to navigate the collection.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

8 parameters
AccountSidstringrequired
The Account SID responsible for the Address resources. Must be exactly 34 characters and match `^AC[0-9a-fA-F]{32}$`.
CustomerNamestringoptional
Filters Address resources by customer name.
FriendlyNamestringoptional
Filters Address resources by the string that identifies them.
EmergencyEnabledbooleanoptional
Filters addresses by whether they can be associated with a number for emergency calling.
IsoCountrystringoptional
Filters Address resources by ISO country code.
PageSizeintegeroptional
Number of resources to return on each page. Must be between 1 and 1000 and defaults to 50 when omitted.
Pageintegeroptional
Page index used to maintain client-side pagination state. Must be zero or greater.
PageTokenstringoptional
Pagination token provided by the API for retrieving a specific page.

1 status code
200Returns a paginated response containing an `addresses` array and pagination metadata, including page links, page boundaries, and page size.
endintegeroptional
first_page_uristringoptional
next_page_uristringoptional
pageintegeroptional
page_sizeintegeroptional
previous_page_uristringoptional
startintegeroptional
uristringoptional
addressesarray<object>optional

Error handling

AccountSid must be exactly 34 characters and match the Account SID format AC followed by 32 hexadecimal characters. PageSize must be between 1 and 1000, and Page must be zero or greater.