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"
  }
}

{
  "OrderId": "JNOID-aabbde7a-....-....-....-............",
  "OrderDate": "2025-05-14T18:00:00.0000000+00:00",
  "Status": "Pending",
  "PhoneNumber": "+11234567890",
  "ICCID": "12345678900987654321"
}

Numbers

Numbers - Port In

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"
  }
}

{
  "OrderId": "JNOID-aabbde7a-....-....-....-............",
  "OrderDate": "2025-05-14T18:00:00.0000000+00:00",
  "Status": "Pending",
  "PhoneNumber": "+11234567890",
  "ICCID": "12345678900987654321"
}

Authorizations

Authorization

string

header

required

Enter the token obtained from the Authentication endpoint

Body

application/json

PortInNumber

string

required

Phone number to port in (E.164 format)

Example:

"+11234567890"

CurrentCarrierName

string

required

Name of the losing carrier

Example:

"Company LLC"

CurrentAccountNumber

string

required

Account number with current carrier

Example:

"4651234567"

CurrentAccountPassword

string

required

Account PIN/password with current carrier

Example:

"0550"

CurrentBillingAddress

object

required

Show child attributes

ICCID

string

SIM card ICCID (optional)

Example:

"8901240397190557414F"

TargetPortinClassification

enum<string>

Classification type for the port-in

Available options:

mvno,

iot

Example:

"mvno"

SubscriberName

string

Name of the subscriber (optional)

Example:

"John Doe"

Response

200 - application/json

Success — returns the port-in order ID and initial status

The response is of type object.

Number Provision (Purchase/Order)Numbers - Port In Eligibility

⌘I

Documentation Index

Authorizations

Body

Response