Get available phone numbers
curl --request GET \
--url https://app.voxial.pt/api/user/assistants/phone-numbers \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.voxial.pt/api/user/assistants/phone-numbers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.voxial.pt/api/user/assistants/phone-numbers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.voxial.pt/api/user/assistants/phone-numbers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.voxial.pt/api/user/assistants/phone-numbers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.voxial.pt/api/user/assistants/phone-numbers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.voxial.pt/api/user/assistants/phone-numbers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 45,
"phone_number": "+1234567890",
"country_code": "US",
"type_label": "Normal",
"is_available": true
},
{
"id": 46,
"phone_number": "+1234567891",
"country_code": "US",
"type_label": "SIP",
"is_available": false
},
{
"id": 47,
"phone_number": "+441234567890",
"country_code": "GB",
"type_label": "Caller ID",
"is_available": true
}
]
Assistants
Get available phone numbers
Retrieve all available phone numbers for assistant assignment
GET
/
user
/
assistants
/
phone-numbers
Get available phone numbers
curl --request GET \
--url https://app.voxial.pt/api/user/assistants/phone-numbers \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.voxial.pt/api/user/assistants/phone-numbers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.voxial.pt/api/user/assistants/phone-numbers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.voxial.pt/api/user/assistants/phone-numbers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.voxial.pt/api/user/assistants/phone-numbers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.voxial.pt/api/user/assistants/phone-numbers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.voxial.pt/api/user/assistants/phone-numbers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": 45,
"phone_number": "+1234567890",
"country_code": "US",
"type_label": "Normal",
"is_available": true
},
{
"id": 46,
"phone_number": "+1234567891",
"country_code": "US",
"type_label": "SIP",
"is_available": false
},
{
"id": 47,
"phone_number": "+441234567890",
"country_code": "GB",
"type_label": "Caller ID",
"is_available": true
}
]
This endpoint returns a list of phone numbers owned by the authenticated user that can be assigned to assistants, with optional filtering by assistant type.
Query Parameters
string
Filter phone numbers by assistant type. Options:
inbound, outboundResponse fields
array
Show properties
Show properties
[
{
"id": 45,
"phone_number": "+1234567890",
"country_code": "US",
"type_label": "Normal",
"is_available": true
},
{
"id": 46,
"phone_number": "+1234567891",
"country_code": "US",
"type_label": "SIP",
"is_available": false
},
{
"id": 47,
"phone_number": "+441234567890",
"country_code": "GB",
"type_label": "Caller ID",
"is_available": true
}
]
Notes
- Only phone numbers owned by the authenticated user are returned
- When
type=inboundis specified, caller ID numbers and already assigned numbers are filtered out - The
is_availablefield indicates if the number can be assigned to a new inbound assistant - Phone numbers are returned in the values collection format (indexed array)
- Use the
idfield when assigning phone numbers to assistants
⌘I

