List available numbers
curl --request GET \
--url https://api.callaro.ai/api/v1/phone_numbers/available \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.callaro.ai/api/v1/phone_numbers/available', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.callaro.ai/api/v1/phone_numbers/available"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {},
"message": "<string>",
"meta": {},
"request_id": "<string>"
}{
"error": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"details": {},
"errors": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"details": {},
"errors": [
"<string>"
]
}PhoneNumbers
List available numbers
Searches the selected carrier for purchasable numbers. Pass provider to choose the carrier flow (defaults to twilio). Query parameters branch per provider: Twilio uses country, type, area_code, contains; Plivo uses country, type (fixed|mobile|tollfree) and pattern/contains. Requires an active connection for the provider.
GET
/
api
/
v1
/
phone_numbers
/
available
List available numbers
curl --request GET \
--url https://api.callaro.ai/api/v1/phone_numbers/available \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.callaro.ai/api/v1/phone_numbers/available', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.callaro.ai/api/v1/phone_numbers/available"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {},
"message": "<string>",
"meta": {},
"request_id": "<string>"
}{
"error": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"details": {},
"errors": [
"<string>"
]
}{
"error": "<string>",
"error_code": "<string>",
"request_id": "<string>",
"details": {},
"errors": [
"<string>"
]
}Authorizations
bearerAuthtenantApiKeypartnerApiKey
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Optional tenant context selector for JWT/partner key callers.
Query Parameters
Carrier to search. Defaults to twilio.
Available options:
twilio, plivo Example:
"US"
Twilio: Local|TollFree. Plivo: fixed|mobile|tollfree.
Twilio only.
Plivo number prefix/pattern.
Was this page helpful?