GET
/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.jsonList incoming phone numbers
Lists incoming phone numbers belonging to an account. Filter the results by beta status, friendly name, phone number, or origin, and use the page parameters to navigate the list.
AccountSidstringrequired
The SID of the account whose incoming phone numbers you want to list. Must use the `AC` prefix followed by 32 hexadecimal characters.
Betabooleanoptional
Whether to include phone numbers new to the platform. Defaults to `true` when omitted.
FriendlyNamestringoptional
Filter by a string that identifies the incoming phone number resources.
PhoneNumberstringoptional
Filter by phone number; you can provide a partial number and use `*` as a wildcard for any digit.
Originstringoptional
Filter by phone number origin: `twilio` or `hosted`. Defaults to including phone numbers of all origins when omitted.
PageSizeintegeroptional
Maximum number of resources to return per page. Defaults to 50 when omitted; must be between 1 and 1000.
Pageintegeroptional
Zero-based page index for client-side page state. Must be a non-negative integer.
PageTokenstringoptional
Page token provided by the API for navigating the list.
200Returns a paginated response containing incoming phone number resources and page metadata, including page size and links to related pages.
endintegeroptional
first_page_uristringoptional
next_page_uristringoptional
pageintegeroptional
page_sizeintegeroptional
previous_page_uristringoptional
startintegeroptional
uristringoptional
incoming_phone_numbersarray<object>optional
Error handling
The AccountSid path parameter must be a 34-character account SID beginning with AC and followed by 32 hexadecimal characters. PageSize must be between 1 and 1000, and Page must be a non-negative integer.