Logo
Zoom Public API Documentation

Get a phone number

GET {{baseUrl}}/phone/numbers/:phoneNumberId

Returns information about an account's Zoom Phone number.

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

Scopes: phone:read:admin

Granular Scopes: phone:read:numbers:admin

Rate Limit Label: LIGHT

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "assignee": { "audio_prompt_language": "<string>", "display_number": "<string>", "extension_number": "<long>", "greeting": { "id": "<string>", "name": "<string>" }, "id": "<string>", "label": "<string>", "meeting_id": "<string>", "name": "<string>", "on_hold_music": { "id": "<string>", "name": "<string>" }, "type": "companyLocation" }, "capability": [ "<string>", "<string>" ], "carrier": { "code": "<integer>", "name": "<string>" }, "display_name": "<string>", "emergency_address": { "address_line1": "<string>", "address_line2": "<string>", "city": "<string>", "country": "<string>", "state_code": "<string>", "zip": "<string>" }, "emergency_address_status": 1, "emergency_address_update_time": "<string>", "id": "<string>", "location": "<string>", "number": "<string>", "number_type": "tollfree", "sip_group": { "display_name": "<string>", "id": "<string>" }, "site": { "id": "<string>", "name": "<string>" }, "source": "internal", "status": "pending" }



Curl
curl -X GET 'https://api.zoom.us/v2/phone/numbers/:phoneNumberId' -H 'Accept: application/json'

ENDPOINTS