List phone numbers

GET

/phone/numbers

A Zoom account owner or admin can purchase phone numbers and assign them to Zoom phone users. Use this API to list all Zoom Phone numbers in a Zoom account. You can filter the response based on your needs by using query parameters.

Prerequisites:

Pro or higher plan with Zoom phone license
Scope: phone:read:admin
Rate Limit Label: Medium

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://api.zoom.us/v2/phone/numbers'

响应示例

{
    "next_page_token": "",
    "page_size": 30,
    "phone_numbers": [
        {
            "assignee": {
                "extension_number": 12,
                "id": "cgfdgfghghim",
                "name": "Peter Jenner",
                "type": "user"
            },
            "capability": [
                "incoming",
                "outgoing"
            ],
            "display_name": "abc",
            "id": "execvbfgbgr",
            "location": "Milpitas,California,United States",
            "number": "0000111100",
            "number_type": "tollfree",
            "site": {
                "id": "sdfsdfgrg",
                "name": "SF office"
            },
            "source": "internal",
            "status": "pending"
        },
        {
            "assignee": {
                "extension_number": 1,
                "id": "dfgdfghdfhgh",
                "name": "Receptionist",
                "type": "autoReceptionist"
            },
            "id": "fdgfdgfdh",
            "location": "San Jose,California,United States",
            "number": "111111111",
            "number_type": "toll",
            "site": {
                "id": "jhdfsdghfdg",
                "name": "San Jose office"
            },
            "source": "external",
            "status": "available"
        }
    ],
    "total_records": 2
}

请求参数

Query 参数

返回响应

🟢200**HTTP Status Code:** `200` **OK**<br> Phone numbers listed successfully.

application/json

Body

修改于 2024-04-24 09:06:48

Change main company number

Get phone number details