Lock Things Group to IMEI range (TAC)

This guide will show you how you can Enable and Disable Master IMEI settings to allow your Thing Group SIM cards to work only with one manufacturer IMEI range (TAC)

Lock Things Group to IMEI range

PUT https://console.monogoto.io/thingsgroup/{THING_GROUP_ID}

Path Parameters

Name

Type

Description

THING_GROUP_ID*

String

The identifier of your Things Group

Headers

Name

Type

Description

TOKEN_HERE*

String

Your authentication token

Request Body

Name

Type

Description

TELEPHONY_PROFILE

String

Things Group Telephony Profile ID

THINGS_GROUP_NAME

String

MASTER_IMEI_STATE

String

Replace with true or false

IMEI_PREFIX

String

Replace with the device IMEI range, also known as a TAC

{
    // Response
}

Example using cURL:

curl -X PUT \
    --url "https://console.monogoto.io/thingsgroup/{THING_GROUP_ID}" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer {TOKEN_HERE}" \
    -d "{ \"TelephonyProfileId\": \"{TELEPHONY_PROFILE}\", \"ThingsGroupName\": \"{THINGS_GROUP_NAME}\", \"IMEIPrefix\": \"{IMEI_PREFIX}\", \"LockMasterImei\": {MASTER_IMEI_STATE}}"

Please note that the above shown command needs to be replaced with information:

{THINGS_GROUP_ID} - replace with Things Group ID
{TOKEN_HERE} - replace with your token
{TELEPHONY_PROFILE_ID} - replace with your Things Group used Telephony Profile ID, this can be retrieved through Get Things Group Information.
{THINGS_GROUP_NAME} - replace with your Things Group used Telephony Profile ID from the first step.
{IMEI_PREFIX} - replace with the device IMEI range, also known as a TAC. In order to restrict Things inside this Thing Group to work only with devices from this IMEI range. Please note that you can send empty value in order to remove IMEI range value.
{MASTER_IMEI_STATE} - replace with true or false value, depending on what you want to do:
- true - Enable Master IMEI limitation to allow only our entered device IMEI range to get SIM card services.
- false - Disable Master IMEI limitation to allow all devices to work with this Thing.

Example of request:

curl -X PUT \
    --url "https://console.monogoto.io/thingsgroup/ThingsGroupId_eej3421b0-bee1-4997-93aa-ce443ca43h347a" \
    -H "accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" \
    -d "{ \"TelephonyProfileId\": \"TelephonyProfile_ad766b40-9577-4d91-4679-01664c6834d9\", \"ThingsGroupName\": \"Project A phones\", \"IMEIPrefix\": \"35305311\", \"LockMasterImei\": true}"

Expected response (should show Thing Group ID):

ThingsGroupId_eej3421b0-bee1-4997-93aa-ce443ca43h347a

Update a Things Group

PUThttps://console.monogoto.io/thingsgroup/{ThingsGroupId}

Path parameters

ThingsGroupId*string

Things Group ID

Body

Things Group structure

Networksarray of string

Networks Identifiers

TelephonyProfileId*string

Telephony Profile ID

ThingsGroupDescription*string

Things Group description

ThingsGroupName*string

Things Group name

ThingsGroupActiveboolean

Things Group Active

ThingsGroupIdstring

Things Group ID

MoSmsWebhookobject

Mobile Originated SMS webhook

MtSmsWebhookstring

Mobile Terminated SMS webhook

StopMtSmsForWebhookboolean

MoVoiceWebhookstring

Mobile Originated Voice webhook

MtVoiceWebhookstring

Mobile Terminated Voice webhook

AlertsWebhookstring

Alerts webhook

ExternalGgsnWebhookstring

SecretKeyForWebhooksstring

Secret key for webhooks

CustomerId*string

Customer ID

RoamingPolicyIdstring

Roaming Policy Id

DeviceTypestring

Get Radio profile/ psm settings/ control plane optimization according to device Type.Option : eNB, PowerMeter, PetTracker , Rectifier, AMT, NB-IoT Devices(External)

TypeSettingsExistboolean

Should to be true , for get the Device Type settings from template.

NonIpboolean

If true, subscribers assigned to this group will support Non-IP pdn type only

PricePlansarray of ThingPricePlans (object)

Price Plans

IMEIPrefixstring

LockMasterImeiboolean

if true we will block/unblock service according to IMEI Prefix attribute

SetPLMNByOTAStatestring

Allowed three states : Inherits - take from next hierarchy level (Customer) , Enable - will create OTA Campaign with OPLMN , PLMN Sel operations if the subscriber connected to network in different country, Disable - will NOT create OTA Campaign

WelcomeSMSStatestring

Allowed three states : Inherits - take from next hierarchy level (Customer) , Enable - will send welcome SMS if the subscriber connected to network in different country, Disable - will NOT send welcome SMS

Response

Things Group updated

Request

const response = await fetch('https://console.monogoto.io/thingsgroup/{ThingsGroupId}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "TelephonyProfileId": "text",
      "ThingsGroupDescription": "text",
      "ThingsGroupName": "text",
      "CustomerId": "text"
    }),
});
const data = await response.json();

Response

{
  "message": "text"
}

PreviousGet Things Group Information NextAlerts

Last updated 6 days ago

const response = await fetch('https://console.monogoto.io/thingsgroup/{ThingsGroupId}', { method: 'PUT', headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "TelephonyProfileId": "text", "ThingsGroupDescription": "text", "ThingsGroupName": "text", "CustomerId": "text" }), }); const data = await response.json();