Back to Monogoto website

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
PreviousGet Things Group InformationNexteSIM

Last updated

Was this helpful?