Purchase Phone Number
curl --request POST \
--url https://api.trillet.ai/v1/api/twilio/purchase-number \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"country": "<string>",
"type": "<string>",
"phoneNumber": "<string>",
"addressSid": "<string>",
"coupon": "<string>"
}
'import requests
url = "https://api.trillet.ai/v1/api/twilio/purchase-number"
payload = {
"country": "<string>",
"type": "<string>",
"phoneNumber": "<string>",
"addressSid": "<string>",
"coupon": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"x-workspace-id": "<x-workspace-id>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-api-key': '<api-key>',
'x-workspace-id': '<x-workspace-id>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
country: '<string>',
type: '<string>',
phoneNumber: '<string>',
addressSid: '<string>',
coupon: '<string>'
})
};
fetch('https://api.trillet.ai/v1/api/twilio/purchase-number', 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://api.trillet.ai/v1/api/twilio/purchase-number",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'country' => '<string>',
'type' => '<string>',
'phoneNumber' => '<string>',
'addressSid' => '<string>',
'coupon' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>",
"x-workspace-id: <x-workspace-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.trillet.ai/v1/api/twilio/purchase-number"
payload := strings.NewReader("{\n \"country\": \"<string>\",\n \"type\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"addressSid\": \"<string>\",\n \"coupon\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("x-workspace-id", "<x-workspace-id>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.trillet.ai/v1/api/twilio/purchase-number")
.header("x-api-key", "<api-key>")
.header("x-workspace-id", "<x-workspace-id>")
.header("Content-Type", "application/json")
.body("{\n \"country\": \"<string>\",\n \"type\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"addressSid\": \"<string>\",\n \"coupon\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trillet.ai/v1/api/twilio/purchase-number")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["x-workspace-id"] = '<x-workspace-id>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"country\": \"<string>\",\n \"type\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"addressSid\": \"<string>\",\n \"coupon\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"phoneNumber": {
"_id": "665a1b2c3d4e5f6a7b8c9d0e",
"phoneNumber": "+14155551234",
"country": "US",
"type": "local",
"status": "active",
"workspaceId": "664a1b2c3d4e5f6a7b8c9d0e"
}
}
Purchase Phone Number
Purchase a phone number for your workspace.
POST
/
v1
/
api
/
twilio
/
purchase-number
Purchase Phone Number
curl --request POST \
--url https://api.trillet.ai/v1/api/twilio/purchase-number \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"country": "<string>",
"type": "<string>",
"phoneNumber": "<string>",
"addressSid": "<string>",
"coupon": "<string>"
}
'import requests
url = "https://api.trillet.ai/v1/api/twilio/purchase-number"
payload = {
"country": "<string>",
"type": "<string>",
"phoneNumber": "<string>",
"addressSid": "<string>",
"coupon": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"x-workspace-id": "<x-workspace-id>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-api-key': '<api-key>',
'x-workspace-id': '<x-workspace-id>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
country: '<string>',
type: '<string>',
phoneNumber: '<string>',
addressSid: '<string>',
coupon: '<string>'
})
};
fetch('https://api.trillet.ai/v1/api/twilio/purchase-number', 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://api.trillet.ai/v1/api/twilio/purchase-number",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'country' => '<string>',
'type' => '<string>',
'phoneNumber' => '<string>',
'addressSid' => '<string>',
'coupon' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>",
"x-workspace-id: <x-workspace-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.trillet.ai/v1/api/twilio/purchase-number"
payload := strings.NewReader("{\n \"country\": \"<string>\",\n \"type\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"addressSid\": \"<string>\",\n \"coupon\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("x-workspace-id", "<x-workspace-id>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.trillet.ai/v1/api/twilio/purchase-number")
.header("x-api-key", "<api-key>")
.header("x-workspace-id", "<x-workspace-id>")
.header("Content-Type", "application/json")
.body("{\n \"country\": \"<string>\",\n \"type\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"addressSid\": \"<string>\",\n \"coupon\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.trillet.ai/v1/api/twilio/purchase-number")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["x-workspace-id"] = '<x-workspace-id>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"country\": \"<string>\",\n \"type\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"addressSid\": \"<string>\",\n \"coupon\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"phoneNumber": {
"_id": "665a1b2c3d4e5f6a7b8c9d0e",
"phoneNumber": "+14155551234",
"country": "US",
"type": "local",
"status": "active",
"workspaceId": "664a1b2c3d4e5f6a7b8c9d0e"
}
}
Headers
string
required
API key used for authenticating requests to the API.
string
required
Workspace identifier for the API.
Request Body
string
required
Country code for the phone number (e.g., “US”, “CA”).
string
required
Type of phone number. Options: “local”, “tollFree”, “mobile”.
string
required
The specific phone number to purchase in E.164 format.
string
Address SID for regulatory compliance (required for some countries).
string
Coupon code for a discount.
Response Fields
boolean
Whether the purchase was successful.
object
{
"success": true,
"phoneNumber": {
"_id": "665a1b2c3d4e5f6a7b8c9d0e",
"phoneNumber": "+14155551234",
"country": "US",
"type": "local",
"status": "active",
"workspaceId": "664a1b2c3d4e5f6a7b8c9d0e"
}
}
⌘I