cURL

curl -X GET 'https://api.telegent.com/v1.0/numbers/order?OrderId=JNUOID-10a3g876-....-....-....-c00a36988653' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "OrderDate": "2025-12-08T00:12:08.89",
  "OrderId": "JNUOID-12390e1f-ef69-4d81-b97b-8d000e763ec9",
  "OrderStatus": "Error",
  "OrderStatusMessage": "8A-ACCOUNT_NUM_REQ_OR_INCORRECT",
  "OrderType": "portin",
  "PhoneNumbersOrdered": [
    {
      "Number": "+12815703894"
    }
  ]
}

Numbers

Order ID Details

Retrieve detailed information about a number provisioning order using the order ID. Returns order status, requested numbers, provisioning results, and any error messages.

What this does: Returns the order status, order type (provision, portin, etc.), associated phone numbers, and any error message codes from the carrier. Multiple example responses are included showing common error states (account number required, number lock). Poll this endpoint after a provision or port-in to confirm completion.

Next steps:

If status is Complete, the number is active — send a test message via POST /v1.0/message/outbound
If status is Error, review the OrderStatusMessage and retry the operation

GET

v1.0

numbers

order

cURL

curl -X GET 'https://api.telegent.com/v1.0/numbers/order?OrderId=JNUOID-10a3g876-....-....-....-c00a36988653' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "OrderDate": "2025-12-08T00:12:08.89",
  "OrderId": "JNUOID-12390e1f-ef69-4d81-b97b-8d000e763ec9",
  "OrderStatus": "Error",
  "OrderStatusMessage": "8A-ACCOUNT_NUM_REQ_OR_INCORRECT",
  "OrderType": "portin",
  "PhoneNumbersOrdered": [
    {
      "Number": "+12815703894"
    }
  ]
}

Authorizations

Authorization

string

header

required

Enter the token obtained from the Authentication endpoint

Query Parameters

OrderId

string

The unique order ID to retrieve details for (e.g., JNUOID-xxxxx)

Response

200 - application/json

Order ID Details

The response is of type object.

Numbers - Port Out Numbers Inventory

⌘I

Documentation Index

Authorizations

Query Parameters

Response