GET
/v1/comms/numbersRead the workspace's phone numbers
Every line this workspace has, bought through us or assigned in Zoom, with what each one can carry, whether we still hold it, and which one is the sending number. Start here for "what numbers do we have". Its sending-number flag is only the workspace's DEFAULT line; which lines this person may use is get_comms_senders.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
API serverbase URL
Bearer tokensessionoptional
Stored only in this browser for the session security scheme and reused on every API page in this group.
Responses
200application/json
the action's answer
{
"numbers": [
{
"boughtAt": "2026-01-01T00:00:00Z",
"e164": "string",
"id": "",
"label": "string",
"managed": true,
"mmsCapable": true,
"provider": "string",
"providerSid": "string",
"releasedAt": "2026-01-01T00:00:00Z",
"sender": true,
"smsCapable": true,
"status": "string",
"voiceCapable": true
}
]
}numbersarray<>required
defaultapplication/json
a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}errorstringrequired