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}