json

{
  "SubscriberId": "SID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
  "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
  "ICCID": "8901240397190002080",
  "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
  "Type": "mvno"
}

curl -X POST https://api.telegent.com/v1.0/subscriptions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "SubscriberId": "SID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
    "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
    "ICCID": "8901240397190002080",
    "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
    "Type": "mvno"
  }'

import requests

url = "https://api.telegent.com/v1.0/subscriptions"

payload = {
    "SubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
    "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
    "ICCID": "8901240397190002080",
    "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
    "Type": "mvno"
}
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({
    SubscriberId: 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
    TNID: 'NID-B5B67F02-708A-1851-20DF-61FC1919C4F6',
    ICCID: '8901240397190002080',
    PackageId: 'PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db',
    Type: 'mvno'
  })
};

fetch('https://api.telegent.com/v1.0/subscriptions', 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/subscriptions",
  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([
    'SubscriberId' => 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
    'TNID' => 'NID-B5B67F02-708A-1851-20DF-61FC1919C4F6',
    'ICCID' => '8901240397190002080',
    'PackageId' => 'PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db',
    'Type' => 'mvno'
  ]),
  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/subscriptions"

	payload := strings.NewReader("{\n  \"SubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"TNID\": \"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6\",\n  \"ICCID\": \"8901240397190002080\",\n  \"PackageId\": \"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db\",\n  \"Type\": \"mvno\"\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/subscriptions")
  .header("Content-Type", "application/json")
  .body("{\n  \"SubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"TNID\": \"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6\",\n  \"ICCID\": \"8901240397190002080\",\n  \"PackageId\": \"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db\",\n  \"Type\": \"mvno\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.telegent.com/v1.0/subscriptions")

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  \"SubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"TNID\": \"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6\",\n  \"ICCID\": \"8901240397190002080\",\n  \"PackageId\": \"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db\",\n  \"Type\": \"mvno\"\n}"

response = http.request(request)
puts response.read_body

{
  "SubscriptionId": "SUB-ef84c0b5-d750-4a5a-99b1-4705089cd20c",
  "SubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
  "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
  "ICCID": "8901240397190002080",
  "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
  "Type": "mvno",
  "Active": true
}

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

Subscriptions

Create Subscription

Prerequisites:

Required: Bearer token — POST /v1.0/oauth2/tokens
Required: Package ID (PID) — POST /v1.0/packages
Required: Subscriber ID (TSUID) — POST /v1.0/subscribers/create

Link a subscriber to a package to grant them access to a set of services. A subscription ties together a subscriber (TSUID), a package (PID), a phone number (TNID), and a SIM card (ICCID) — all four are required. The subscriber, package, and phone number must all exist before creating the subscription. Active subscriptions determine what services and capabilities are available to the subscriber.

What this does: Returns the new SubscriptionId (SUB-) and full subscription record. Creating a subscription links the subscriber to a package, granting them the services and capabilities defined in that package.

Next steps:

Confirm the subscription — GET /v1.0/subscriptions
View the package contents — GET /v1.0/packages/items

POST

v1.0

subscriptions

json

{
  "SubscriberId": "SID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
  "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
  "ICCID": "8901240397190002080",
  "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
  "Type": "mvno"
}

curl -X POST https://api.telegent.com/v1.0/subscriptions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "SubscriberId": "SID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
    "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
    "ICCID": "8901240397190002080",
    "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
    "Type": "mvno"
  }'

import requests

url = "https://api.telegent.com/v1.0/subscriptions"

payload = {
    "SubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
    "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
    "ICCID": "8901240397190002080",
    "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
    "Type": "mvno"
}
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({
    SubscriberId: 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
    TNID: 'NID-B5B67F02-708A-1851-20DF-61FC1919C4F6',
    ICCID: '8901240397190002080',
    PackageId: 'PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db',
    Type: 'mvno'
  })
};

fetch('https://api.telegent.com/v1.0/subscriptions', 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/subscriptions",
  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([
    'SubscriberId' => 'TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d',
    'TNID' => 'NID-B5B67F02-708A-1851-20DF-61FC1919C4F6',
    'ICCID' => '8901240397190002080',
    'PackageId' => 'PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db',
    'Type' => 'mvno'
  ]),
  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/subscriptions"

	payload := strings.NewReader("{\n  \"SubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"TNID\": \"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6\",\n  \"ICCID\": \"8901240397190002080\",\n  \"PackageId\": \"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db\",\n  \"Type\": \"mvno\"\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/subscriptions")
  .header("Content-Type", "application/json")
  .body("{\n  \"SubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"TNID\": \"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6\",\n  \"ICCID\": \"8901240397190002080\",\n  \"PackageId\": \"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db\",\n  \"Type\": \"mvno\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.telegent.com/v1.0/subscriptions")

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  \"SubscriberId\": \"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d\",\n  \"TNID\": \"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6\",\n  \"ICCID\": \"8901240397190002080\",\n  \"PackageId\": \"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db\",\n  \"Type\": \"mvno\"\n}"

response = http.request(request)
puts response.read_body

{
  "SubscriptionId": "SUB-ef84c0b5-d750-4a5a-99b1-4705089cd20c",
  "SubscriberId": "TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d",
  "TNID": "NID-B5B67F02-708A-1851-20DF-61FC1919C4F6",
  "ICCID": "8901240397190002080",
  "PackageId": "PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db",
  "Type": "mvno",
  "Active": true
}

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

Query Parameters

SubscriptionId

string

Body

application/json

SubscriberId

string

required

Telegent Subscriber ID. Format: TSUID- followed by a UUID. Create one via POST /v1.0/subscribers/create or look up existing IDs with GET /v1.0/subscribers/get.

Example:

"TSUID-d7b3-4696-bdd9-5b407d9e99ee-3985-444b8d"

TNID

string

required

Telephone Number ID. Required.

Example:

"NID-B5B67F02-708A-1851-20DF-61FC1919C4F6"

ICCID

string

required

SIM Card ICCID. Required.

Example:

"8901240397190002080"

PackageId

string

required

Package ID to subscribe to

Example:

"PID-9a8435dc-ca6e-4a98-b761-5e6dc04447db"

Type

string

required

Subscription type

Example:

"mvno"

Response

Success — returns the new Subscription ID (SUB-) and associated details

The response is of type object.

Get Subscription Details Update Subscription

⌘I

Overview

OAuth2

Numbers

Voicemail

Message

Accounts

Voice

Services

Sims

Products

Packages

Subscriptions

Distributors

Subscribers

Workgroups

Webhooks

Create Subscription

Query Parameters

Body

Response