List peering phone numbers

GET {{baseUrl}}/phone/peering/numbers?page_size=30&next_page_token=BJLYC6PABbAHdjwSkGVQeeR6B1juwHqj3G2&phone_number=18108001001&carrier_code=8801

Use this API to return phone numbers that were added to Zoom through the Provider Exchange.

Note : Phone peering API and events are for use by partners that have completed the MoU to peer with Zoom. To become a peering provider/ carrier, please submit your request .

Scopes: phone_peering:read:admin , phone_peering:master
Rate Limit Label : Light

Prerequisites:

  • A Business or Enterprise account
  • A Zoom Phone license

Request Params

| Key | Datatype | Required | Description | | page_size | number | | The total number of records returned from a single API call. | | next_page_token | string | | The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes. | | phone_number | number | | Either the sender's or receiver's phone number, to limit the list of SMS sessions. | | carrier_code | number | | The carrier's code. The clientId is used to map to a carrier peered with Zoom.

This parameter is required if you do not use an OAuth token or the OAuth token does not contain the clientId. |

HEADERS

| Key | Datatype | Required | Description | | Accept | string | | |

RESPONSES

status: OK

{"next_page_token":"8X8xSdRVKHsabD6Im4tIPODq6GzDOvV5fO1","numbers":[{"phone_number":"+18108001001","status":0,"assigned":1,"sip_trunk_name":"test-carrier-sip-trunk","billing_reference_id":"Some billing referenceId","service_info":"Some service info"},{"phone_number":"+18108001001","status":0,"assigned":1,"sip_trunk_name":"test-carrier-sip-trunk","billing_reference_id":"Some billing referenceId","service_info":"Some service info"}],"total_records":20}