List phone numbers

GET {{baseUrl}}/phone/carrier_reseller/numbers?page_size=<integer>&next_page_token=<string>&assigned_status=unassigned&sub_account_id=<string>&keyword=<string>

Use this API to list phone numbers in a carrier reseller (master) account that can be pushed to its subaccounts.

Prerequisites: * A Pro or higher account plan * A Zoom Phone license

Scopes: phone:read:admin

Granular Scopes: phone:read:list_carrier_numbers:admin

Rate Limit Label: Medium

Request Params

KeyDatatypeRequiredDescription
page_sizestringThe size of the page.
next_page_tokenstringThe current page number of returned records.
assigned_statusstringNumber assignment status.
sub_account_idstringPartner account ID from sub-account.
keywordstringPartial string of the phone number.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;carrier_reseller_numbers&quot;:[{&quot;assigned_status&quot;:&quot;unassigned&quot;,&quot;carrier_code&quot;:&quot;\u003cinteger\u003e&quot;,&quot;country_iso_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;inactive&quot;,&quot;sub_account_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;sub_account_name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;assigned_status&quot;:&quot;returned&quot;,&quot;carrier_code&quot;:&quot;\u003cinteger\u003e&quot;,&quot;country_iso_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;active&quot;,&quot;sub_account_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;sub_account_name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;total_records&quot;:&quot;\u003cinteger\u003e&quot;}