json
{
"PortInNumber": "+15555551234",
"ICCID": "8901240397190195850",
"CurrentCarrierName": "Telegent",
"CurrentAccountNumber": "46512222",
"CurrentAccountPassword": "0000",
"TargetPortinClassification": "mvno",
"SubscriberName": "Telegent",
"CurrentBillingAddress": {
"Street1": "2701 N Thanksgiving Way",
"Street2": "Suite 202",
"City": "Lehi",
"State": "UT",
"Zip": "84043"
}
}curl -X POST https://api.telegent.com/v1.0/numbers/portin \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"PortInNumber": "+15555551234",
"ICCID": "8901240397190195850",
"CurrentCarrierName": "Telegent",
"CurrentAccountNumber": "46512222",
"CurrentAccountPassword": "0000",
"TargetPortinClassification": "mvno",
"SubscriberName": "Telegent",
"CurrentBillingAddress": {"Street1": "2701 N Thanksgiving Way", "Street2": "Suite 202", "City": "Lehi", "State": "UT", "Zip": "84043"}
}'import requests
url = "https://api.telegent.com/v1.0/numbers/portin"
payload = {
"PortInNumber": "+11234567890",
"CurrentCarrierName": "Company LLC",
"CurrentAccountNumber": "4651234567",
"CurrentBillingAddress": {
"Street1": "123 N Adddress Way",
"City": "Townsville",
"State": "UT",
"Zip": "84048",
"Street2": "Suite 010"
},
"CurrentAccountPassword": "0550",
"ICCID": "8901240397190557414F",
"TargetPortinClassification": "mvno",
"SubscriberName": "John Doe",
"MessageType": "a2p",
"MessageEnabled": True,
"MmsMessageEnabled": True,
"MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
"VoiceEnabled": True,
"VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
"DataEnabled": True,
"AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
"ProductType": "Sms+Data+Voice"
}
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({
PortInNumber: '+11234567890',
CurrentCarrierName: 'Company LLC',
CurrentAccountNumber: '4651234567',
CurrentBillingAddress: {
Street1: '123 N Adddress Way',
City: 'Townsville',
State: 'UT',
Zip: '84048',
Street2: 'Suite 010'
},
CurrentAccountPassword: '0550',
ICCID: '8901240397190557414F',
TargetPortinClassification: 'mvno',
SubscriberName: 'John Doe',
MessageType: 'a2p',
MessageEnabled: true,
MmsMessageEnabled: true,
MessageRouteId: 'MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee',
VoiceEnabled: true,
VoiceRouteId: 'CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe',
DataEnabled: true,
AssignedSubscriberId: 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
ProductType: 'Sms+Data+Voice'
})
};
fetch('https://api.telegent.com/v1.0/numbers/portin', 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/portin",
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([
'PortInNumber' => '+11234567890',
'CurrentCarrierName' => 'Company LLC',
'CurrentAccountNumber' => '4651234567',
'CurrentBillingAddress' => [
'Street1' => '123 N Adddress Way',
'City' => 'Townsville',
'State' => 'UT',
'Zip' => '84048',
'Street2' => 'Suite 010'
],
'CurrentAccountPassword' => '0550',
'ICCID' => '8901240397190557414F',
'TargetPortinClassification' => 'mvno',
'SubscriberName' => 'John Doe',
'MessageType' => 'a2p',
'MessageEnabled' => true,
'MmsMessageEnabled' => true,
'MessageRouteId' => 'MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee',
'VoiceEnabled' => true,
'VoiceRouteId' => 'CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe',
'DataEnabled' => true,
'AssignedSubscriberId' => 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
'ProductType' => 'Sms+Data+Voice'
]),
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/portin"
payload := strings.NewReader("{\n \"PortInNumber\": \"+11234567890\",\n \"CurrentCarrierName\": \"Company LLC\",\n \"CurrentAccountNumber\": \"4651234567\",\n \"CurrentBillingAddress\": {\n \"Street1\": \"123 N Adddress Way\",\n \"City\": \"Townsville\",\n \"State\": \"UT\",\n \"Zip\": \"84048\",\n \"Street2\": \"Suite 010\"\n },\n \"CurrentAccountPassword\": \"0550\",\n \"ICCID\": \"8901240397190557414F\",\n \"TargetPortinClassification\": \"mvno\",\n \"SubscriberName\": \"John Doe\",\n \"MessageType\": \"a2p\",\n \"MessageEnabled\": true,\n \"MmsMessageEnabled\": true,\n \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n \"VoiceEnabled\": true,\n \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n \"DataEnabled\": true,\n \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n \"ProductType\": \"Sms+Data+Voice\"\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/portin")
.header("Content-Type", "application/json")
.body("{\n \"PortInNumber\": \"+11234567890\",\n \"CurrentCarrierName\": \"Company LLC\",\n \"CurrentAccountNumber\": \"4651234567\",\n \"CurrentBillingAddress\": {\n \"Street1\": \"123 N Adddress Way\",\n \"City\": \"Townsville\",\n \"State\": \"UT\",\n \"Zip\": \"84048\",\n \"Street2\": \"Suite 010\"\n },\n \"CurrentAccountPassword\": \"0550\",\n \"ICCID\": \"8901240397190557414F\",\n \"TargetPortinClassification\": \"mvno\",\n \"SubscriberName\": \"John Doe\",\n \"MessageType\": \"a2p\",\n \"MessageEnabled\": true,\n \"MmsMessageEnabled\": true,\n \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n \"VoiceEnabled\": true,\n \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n \"DataEnabled\": true,\n \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n \"ProductType\": \"Sms+Data+Voice\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telegent.com/v1.0/numbers/portin")
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 \"PortInNumber\": \"+11234567890\",\n \"CurrentCarrierName\": \"Company LLC\",\n \"CurrentAccountNumber\": \"4651234567\",\n \"CurrentBillingAddress\": {\n \"Street1\": \"123 N Adddress Way\",\n \"City\": \"Townsville\",\n \"State\": \"UT\",\n \"Zip\": \"84048\",\n \"Street2\": \"Suite 010\"\n },\n \"CurrentAccountPassword\": \"0550\",\n \"ICCID\": \"8901240397190557414F\",\n \"TargetPortinClassification\": \"mvno\",\n \"SubscriberName\": \"John Doe\",\n \"MessageType\": \"a2p\",\n \"MessageEnabled\": true,\n \"MmsMessageEnabled\": true,\n \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n \"VoiceEnabled\": true,\n \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n \"DataEnabled\": true,\n \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n \"ProductType\": \"Sms+Data+Voice\"\n}"
response = http.request(request)
puts response.read_body{
"OrderId": "JNOID-aabbde7a-....-....-....-............",
"OrderDate": "2025-05-14T18:00:00.0000000+00:00",
"Status": "Pending",
"PhoneNumber": "+11234567890",
"ICCID": "12345678900987654321"
}{
"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
Numbers - Port In
Rate limit: This endpoint is limited to 1 request per second, separate from the API-wide 120 requests/minute limit. Exceeding it returns HTTP
429 Too Many Requests.
Prerequisites:
- Required: Bearer token —
POST /v1.0/oauth2/tokens - Recommended: Confirm the number is portable first —
POST /v1.0/numbers/portin/eligibility - Required: Losing carrier name, account number, account password, and subscriber billing address
Transfer an existing phone number from another carrier into your Telegent account. Before submitting a port-in, run the Port-In Eligibility check to confirm the number can be ported. You will need the losing carrier name, account number, account password, and the subscriber’s billing address for LNP (Local Number Portability) compliance.
What this does: Submits the port request to the carrier and returns an OrderId with an initial status of Pending. Monitor the order using the OrderId. Port requests typically take 1-5 business days to complete.
Next steps:
- Track the port order status —
GET /v1.0/numbers/order - Cancel if needed —
POST /v1.0/numbers/portin/cancel
POST
/
v1.0
/
numbers
/
portin
json
{
"PortInNumber": "+15555551234",
"ICCID": "8901240397190195850",
"CurrentCarrierName": "Telegent",
"CurrentAccountNumber": "46512222",
"CurrentAccountPassword": "0000",
"TargetPortinClassification": "mvno",
"SubscriberName": "Telegent",
"CurrentBillingAddress": {
"Street1": "2701 N Thanksgiving Way",
"Street2": "Suite 202",
"City": "Lehi",
"State": "UT",
"Zip": "84043"
}
}curl -X POST https://api.telegent.com/v1.0/numbers/portin \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"PortInNumber": "+15555551234",
"ICCID": "8901240397190195850",
"CurrentCarrierName": "Telegent",
"CurrentAccountNumber": "46512222",
"CurrentAccountPassword": "0000",
"TargetPortinClassification": "mvno",
"SubscriberName": "Telegent",
"CurrentBillingAddress": {"Street1": "2701 N Thanksgiving Way", "Street2": "Suite 202", "City": "Lehi", "State": "UT", "Zip": "84043"}
}'import requests
url = "https://api.telegent.com/v1.0/numbers/portin"
payload = {
"PortInNumber": "+11234567890",
"CurrentCarrierName": "Company LLC",
"CurrentAccountNumber": "4651234567",
"CurrentBillingAddress": {
"Street1": "123 N Adddress Way",
"City": "Townsville",
"State": "UT",
"Zip": "84048",
"Street2": "Suite 010"
},
"CurrentAccountPassword": "0550",
"ICCID": "8901240397190557414F",
"TargetPortinClassification": "mvno",
"SubscriberName": "John Doe",
"MessageType": "a2p",
"MessageEnabled": True,
"MmsMessageEnabled": True,
"MessageRouteId": "MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee",
"VoiceEnabled": True,
"VoiceRouteId": "CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe",
"DataEnabled": True,
"AssignedSubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
"ProductType": "Sms+Data+Voice"
}
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({
PortInNumber: '+11234567890',
CurrentCarrierName: 'Company LLC',
CurrentAccountNumber: '4651234567',
CurrentBillingAddress: {
Street1: '123 N Adddress Way',
City: 'Townsville',
State: 'UT',
Zip: '84048',
Street2: 'Suite 010'
},
CurrentAccountPassword: '0550',
ICCID: '8901240397190557414F',
TargetPortinClassification: 'mvno',
SubscriberName: 'John Doe',
MessageType: 'a2p',
MessageEnabled: true,
MmsMessageEnabled: true,
MessageRouteId: 'MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee',
VoiceEnabled: true,
VoiceRouteId: 'CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe',
DataEnabled: true,
AssignedSubscriberId: 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
ProductType: 'Sms+Data+Voice'
})
};
fetch('https://api.telegent.com/v1.0/numbers/portin', 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/portin",
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([
'PortInNumber' => '+11234567890',
'CurrentCarrierName' => 'Company LLC',
'CurrentAccountNumber' => '4651234567',
'CurrentBillingAddress' => [
'Street1' => '123 N Adddress Way',
'City' => 'Townsville',
'State' => 'UT',
'Zip' => '84048',
'Street2' => 'Suite 010'
],
'CurrentAccountPassword' => '0550',
'ICCID' => '8901240397190557414F',
'TargetPortinClassification' => 'mvno',
'SubscriberName' => 'John Doe',
'MessageType' => 'a2p',
'MessageEnabled' => true,
'MmsMessageEnabled' => true,
'MessageRouteId' => 'MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee',
'VoiceEnabled' => true,
'VoiceRouteId' => 'CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe',
'DataEnabled' => true,
'AssignedSubscriberId' => 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
'ProductType' => 'Sms+Data+Voice'
]),
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/portin"
payload := strings.NewReader("{\n \"PortInNumber\": \"+11234567890\",\n \"CurrentCarrierName\": \"Company LLC\",\n \"CurrentAccountNumber\": \"4651234567\",\n \"CurrentBillingAddress\": {\n \"Street1\": \"123 N Adddress Way\",\n \"City\": \"Townsville\",\n \"State\": \"UT\",\n \"Zip\": \"84048\",\n \"Street2\": \"Suite 010\"\n },\n \"CurrentAccountPassword\": \"0550\",\n \"ICCID\": \"8901240397190557414F\",\n \"TargetPortinClassification\": \"mvno\",\n \"SubscriberName\": \"John Doe\",\n \"MessageType\": \"a2p\",\n \"MessageEnabled\": true,\n \"MmsMessageEnabled\": true,\n \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n \"VoiceEnabled\": true,\n \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n \"DataEnabled\": true,\n \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n \"ProductType\": \"Sms+Data+Voice\"\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/portin")
.header("Content-Type", "application/json")
.body("{\n \"PortInNumber\": \"+11234567890\",\n \"CurrentCarrierName\": \"Company LLC\",\n \"CurrentAccountNumber\": \"4651234567\",\n \"CurrentBillingAddress\": {\n \"Street1\": \"123 N Adddress Way\",\n \"City\": \"Townsville\",\n \"State\": \"UT\",\n \"Zip\": \"84048\",\n \"Street2\": \"Suite 010\"\n },\n \"CurrentAccountPassword\": \"0550\",\n \"ICCID\": \"8901240397190557414F\",\n \"TargetPortinClassification\": \"mvno\",\n \"SubscriberName\": \"John Doe\",\n \"MessageType\": \"a2p\",\n \"MessageEnabled\": true,\n \"MmsMessageEnabled\": true,\n \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n \"VoiceEnabled\": true,\n \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n \"DataEnabled\": true,\n \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n \"ProductType\": \"Sms+Data+Voice\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telegent.com/v1.0/numbers/portin")
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 \"PortInNumber\": \"+11234567890\",\n \"CurrentCarrierName\": \"Company LLC\",\n \"CurrentAccountNumber\": \"4651234567\",\n \"CurrentBillingAddress\": {\n \"Street1\": \"123 N Adddress Way\",\n \"City\": \"Townsville\",\n \"State\": \"UT\",\n \"Zip\": \"84048\",\n \"Street2\": \"Suite 010\"\n },\n \"CurrentAccountPassword\": \"0550\",\n \"ICCID\": \"8901240397190557414F\",\n \"TargetPortinClassification\": \"mvno\",\n \"SubscriberName\": \"John Doe\",\n \"MessageType\": \"a2p\",\n \"MessageEnabled\": true,\n \"MmsMessageEnabled\": true,\n \"MessageRouteId\": \"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee\",\n \"VoiceEnabled\": true,\n \"VoiceRouteId\": \"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe\",\n \"DataEnabled\": true,\n \"AssignedSubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n \"ProductType\": \"Sms+Data+Voice\"\n}"
response = http.request(request)
puts response.read_body{
"OrderId": "JNOID-aabbde7a-....-....-....-............",
"OrderDate": "2025-05-14T18:00:00.0000000+00:00",
"Status": "Pending",
"PhoneNumber": "+11234567890",
"ICCID": "12345678900987654321"
}{
"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
application/json
Phone number to port in (E.164 format)
Example:
"+11234567890"
Name of the losing carrier
Example:
"Company LLC"
Account number with current carrier
Example:
"4651234567"
Show child attributes
Show child attributes
Account PIN/password with current carrier (optional)
Example:
"0550"
SIM card ICCID (optional)
Example:
"8901240397190557414F"
Classification type for the port-in
Available options:
mvno, iot Example:
"mvno"
Name of the subscriber (optional)
Example:
"John Doe"
Message type: a2p (Application-to-Person) or p2p (Person-to-Person)
Available options:
a2p, p2p Example:
"a2p"
Enable SMS on the ported-in number. Independent of MMS — set the MmsMessageEnabled field to control MMS.
Example:
true
Optional. Enable MMS on the ported-in number. Independent of MessageEnabled (SMS). MMS can also be changed later via POST /v1.0/numbers/mms/update.
Example:
true
MRID for message routing configuration (required when SMS or MMS is enabled)
Example:
"MRID-73af1e73-d7b3-4696-bdd9-5b407d9e99ee"
Enable voice call capabilities
Example:
true
CRID for voice routing configuration (required when voice is enabled)
Example:
"CRID-4dec6beb-3985-444b-8c06-8baa5jjvawe"
Enable data capabilities (for IoT numbers)
Example:
true
Telegent Subscriber ID to assign to the number (optional). Format: TSUID- followed by a UUID.
Example:
"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d"
Product type for the number
Available options:
Sms-Only, Data-Only, Sms+Data, Sms+Data+Voice Example:
"Sms+Data+Voice"
Response
Success — returns the port-in order ID and initial status
The response is of type object.