{
"StatusChange": "replace",
"EffectiveDate": "12/31/2023",
"AreaCode": "201",
"ZipCode": "84043",
"PhoneNumbers": [
{
"Number": "+12016093801",
"ICCID": "202620160938010123"
},
{
"Number": "+12232233180",
"ICCID": "202620160938010123"
}
]
}curl -X POST https://api.telegent.com/v1.0/numbers/status \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"StatusChange": "replace",
"EffectiveDate": "12/31/2023",
"AreaCode": "201",
"ZipCode": "84043",
"PhoneNumbers": [{"Number": "+12016093801"}, {"Number": "+12232233180"}]
}'import requests
url = "https://api.telegent.com/v1.0/numbers/status"
payload = {
"StatusChange": "replace",
"EffectiveDate": "12/31/2023",
"PhoneNumbers": [{ "Number": "+12016093801" }],
"AreaCode": "201",
"ZipCode": "84043"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
StatusChange: 'replace',
EffectiveDate: '12/31/2023',
PhoneNumbers: [{Number: '+12016093801'}],
AreaCode: '201',
ZipCode: '84043'
})
};
fetch('https://api.telegent.com/v1.0/numbers/status', 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.telegent.com/v1.0/numbers/status",
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([
'StatusChange' => 'replace',
'EffectiveDate' => '12/31/2023',
'PhoneNumbers' => [
[
'Number' => '+12016093801'
]
],
'AreaCode' => '201',
'ZipCode' => '84043'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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.telegent.com/v1.0/numbers/status"
payload := strings.NewReader("{\n \"StatusChange\": \"replace\",\n \"EffectiveDate\": \"12/31/2023\",\n \"PhoneNumbers\": [\n {\n \"Number\": \"+12016093801\"\n }\n ],\n \"AreaCode\": \"201\",\n \"ZipCode\": \"84043\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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.telegent.com/v1.0/numbers/status")
.header("Content-Type", "application/json")
.body("{\n \"StatusChange\": \"replace\",\n \"EffectiveDate\": \"12/31/2023\",\n \"PhoneNumbers\": [\n {\n \"Number\": \"+12016093801\"\n }\n ],\n \"AreaCode\": \"201\",\n \"ZipCode\": \"84043\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telegent.com/v1.0/numbers/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"StatusChange\": \"replace\",\n \"EffectiveDate\": \"12/31/2023\",\n \"PhoneNumbers\": [\n {\n \"Number\": \"+12016093801\"\n }\n ],\n \"AreaCode\": \"201\",\n \"ZipCode\": \"84043\"\n}"
response = http.request(request)
puts response.read_body{
"OrderId": "JNUOID-9df281cc-82ac-48fc-b8bf-edc0a5547f04",
"OrderDate": "2025-05-15T18:20:58.5133475Z",
"OrderStatus": "Complete",
"ChangeType": "activate",
"EffectiveDate": "2023-12-31T00:00:00",
"Numbers": [
{
"Number": "+12016093801",
"QrCode": "https://qrcodeimage.com"
},
{
"Number": "+12016093802",
"QrCode": "https://qrcodeimage.com"
}
]
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}Numbers Status
Swap limit: A number can only be swapped twice every 120 days. Additional
Swaprequests for the same number within that rolling window will be rejected.
Check the current status of one or more phone numbers including provisioning state, active services, and any pending changes or issues.
What this does: Returns the status result for each number in the batch. Use action codes such as Cancel, Park, Swap, Replace, Swap-Sim, or Activate to change number lifecycle state. Each result includes the number, the action taken, and success or error status.
Next steps:
- Confirm new number state —
GET /v1.0/numbers - View inventory —
GET /v1.0/numbers/inventory
{
"StatusChange": "replace",
"EffectiveDate": "12/31/2023",
"AreaCode": "201",
"ZipCode": "84043",
"PhoneNumbers": [
{
"Number": "+12016093801",
"ICCID": "202620160938010123"
},
{
"Number": "+12232233180",
"ICCID": "202620160938010123"
}
]
}curl -X POST https://api.telegent.com/v1.0/numbers/status \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"StatusChange": "replace",
"EffectiveDate": "12/31/2023",
"AreaCode": "201",
"ZipCode": "84043",
"PhoneNumbers": [{"Number": "+12016093801"}, {"Number": "+12232233180"}]
}'import requests
url = "https://api.telegent.com/v1.0/numbers/status"
payload = {
"StatusChange": "replace",
"EffectiveDate": "12/31/2023",
"PhoneNumbers": [{ "Number": "+12016093801" }],
"AreaCode": "201",
"ZipCode": "84043"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
StatusChange: 'replace',
EffectiveDate: '12/31/2023',
PhoneNumbers: [{Number: '+12016093801'}],
AreaCode: '201',
ZipCode: '84043'
})
};
fetch('https://api.telegent.com/v1.0/numbers/status', 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.telegent.com/v1.0/numbers/status",
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([
'StatusChange' => 'replace',
'EffectiveDate' => '12/31/2023',
'PhoneNumbers' => [
[
'Number' => '+12016093801'
]
],
'AreaCode' => '201',
'ZipCode' => '84043'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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.telegent.com/v1.0/numbers/status"
payload := strings.NewReader("{\n \"StatusChange\": \"replace\",\n \"EffectiveDate\": \"12/31/2023\",\n \"PhoneNumbers\": [\n {\n \"Number\": \"+12016093801\"\n }\n ],\n \"AreaCode\": \"201\",\n \"ZipCode\": \"84043\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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.telegent.com/v1.0/numbers/status")
.header("Content-Type", "application/json")
.body("{\n \"StatusChange\": \"replace\",\n \"EffectiveDate\": \"12/31/2023\",\n \"PhoneNumbers\": [\n {\n \"Number\": \"+12016093801\"\n }\n ],\n \"AreaCode\": \"201\",\n \"ZipCode\": \"84043\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telegent.com/v1.0/numbers/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"StatusChange\": \"replace\",\n \"EffectiveDate\": \"12/31/2023\",\n \"PhoneNumbers\": [\n {\n \"Number\": \"+12016093801\"\n }\n ],\n \"AreaCode\": \"201\",\n \"ZipCode\": \"84043\"\n}"
response = http.request(request)
puts response.read_body{
"OrderId": "JNUOID-9df281cc-82ac-48fc-b8bf-edc0a5547f04",
"OrderDate": "2025-05-15T18:20:58.5133475Z",
"OrderStatus": "Complete",
"ChangeType": "activate",
"EffectiveDate": "2023-12-31T00:00:00",
"Numbers": [
{
"Number": "+12016093801",
"QrCode": "https://qrcodeimage.com"
},
{
"Number": "+12016093802",
"QrCode": "https://qrcodeimage.com"
}
]
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}{
"StatusCode": 123,
"Message": "<string>"
}Body
Type of status change to perform
activate, cancel, swap, swap-sim, replace, park "replace"
Date when status change takes effect (MM/DD/YYYY)
"12/31/2023"
Array of phone numbers to update
Show child attributes
Show child attributes
Area code for swap/replace (searched first)
"201"
Zip code for swap/replace (if area code unavailable)
"84043"
Response
Numbers Activate
The response is of type object.