Get Things Group Information

This guide will show you how you can receive information about a Thing Group via an API command.

Get Things Group Information

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

Path Parameters

Name	Type	Description
THING_GROUP_ID*	String	Identifier of Things Group. Use * to get information about all groups

Headers

Name	Type	Description
YOUR_TOKEN*	String	Your authentication token
CUSTOMER_ID*	String	Customer API key (equal to customer ID)

200: OK OK

{
    // Response
}

Example using cURL:

curl -X GET \
    --url "https://console.monogoto.io/thingsgroup/{THING_GROUP_ID}" \
    -H "accept: application/json" \
    -H "Authorization: Bearer {TOKEN_HERE}" \
    -H "{CUSTOMER_ID}"

Add your Token, THING_GROUP_ID and CUSTOMER_ID in the GET request to successfully execute the command.

THING_GROUP_ID - to see information about all of your Thing Groups, enter * instead of a specific ThingGroupID

Example of request to show information about all of our Thing Groups:

curl -X GET \
    --url "https://console.monogoto.io/thingsgroup/*" \
    -H "accept: application/json" \
    -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" \
    -H "apikey: cid_ecs1d3a5-f5e62a1-fe8af468wf"

Expected result:

[{
    "CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
    "DateCreated": 1593166682627,
    "DateModified": 1608028286036,
    "MaxCounter": 0,
    "MoSmsWebhook": {},
    "Networks": ["NetworkId_b0cc777b-8349-4eb8-b4e0-aa18d71a903e", "NetworkId_5eab2280-acaf-4565-b4fc-92f5d6a0fab261", "NetworkId_730s86a4bd-96c9-4cb5-9d84-c7ea4t5s9"],
    "RoamingPolicies": [],
    "TelephonyProfileId": "TelephonyProfile_ad8440-9577-8557-9a79-016abct41834d10",
    "TelephonyProfileName": "Default telephony profile",
    "ThingsGroupActive": true,
    "ThingsGroupDescription": "This is a Demo Thing Group",
    "ThingsGroupId": "ThingsGroupId_b6686b81-a624-4c87-8g96-dfd06732b417",
    "ThingsGroupName": "Demo",
    "Type": "ThingsGroupId"
}, {
    "CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
    "DateCreated": 1601042185386,
    "DateModified": 1610982144804,
    "MaxCounter": 0,
    "MoSmsWebhook": {
        "StopSms": false,
        "webhook": ""
 
 ...

Example of request to show information only about a single Thing Group:

curl -X GET \
    --url "https://console.monogoto.io/thingsgroup/ThingsGroupId_ee6421b0-bee0-4587-93aa-cee6ca9b017a" \
    -H "accept: application/json" \
    -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" \
    -H "apikey: cid_ecs1d3a5-f5e62a1-fe8af468wf"

Expected result:

[
  {
    "CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
    "DateCreated": 1601042185386,
    "DateModified": 1610982144804,
    "MaxCounter": 0,
    "MoSmsWebhook": {
      "StopSms": false,
      "webhook": ""
    },
    "Networks": [
      "NetworkId_730166bd-96c9-4cb5-9d84-c7eff5081689",
      "NetworkId_b0cc777b-8349-4eb8-b4e0-aa18d71a903e",
      "NetworkId_5eab2280-acaf-4565-b49c-92f4a0fab261"
    ],
    "NonIp": false,
    "RoamingPolicies": [
      {
        "NetworkProviderId": "NetworkProviderId_5a12b2ca5-8f6c-4cb5-879i-d73516bbc8af",
        "RoamingPolicyId": "RoamingPlanId_d1954416-3ab2-4d15-9b89-99892bt4c856",
        "RoamingRestrictions": [
          {
    
    ...

Gets list of groups (or specific group) with Telephony profile and Network Information

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

Path parameters

ThingsGroupId*string

Things GroupId ( * parameter returns all records without filtering on specific GroupId)

Response

200401404500

JSON of Things Group security and network information

Body

application/json

DateCreated*number

Date Created

DateModified*number

Date Modified

Networks*array of NetworkData (object)

Networks

TelephonyProfileId*string

Telephony Profile ID

TelephonyProfileName*string

Telephony Profile Name

ThingsGroupActive*boolean

Things Group Active

ThingsGroupDescription*string

Things Group description

ThingsGroupId*string

Things Group ID

ThingsGroupName*string

Things Group name

Type*string

Things Group Type Key

MoSmsWebhookobject

Mobile Originated SMS webhook

MtSmsWebhookstring

Mobile Terminated SMS webhook

StopMtSmsForWebhookboolean

MoVoiceWebhookstring

Mobile Originated Voice webhook

MtVoiceWebhookstring

Mobile Terminated SMS webhook

ExternalGgsnWebhookstring

CustomerIdstring

Customer ID

RoamingPolicyIdstring

Roaming Policy Id

NonIpboolean

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

IMEIPrefixstring

LockMasterImeiboolean

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

Request

JavaScriptCurlPython

const response = await fetch('https://console.monogoto.io/thingsgroup/{ThingsGroupId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404500

{
  "DateCreated": 0,
  "DateModified": 0,
  "Networks": [
    {
      "NetworkId": "text",
      "NetworkName": "text"
    }
  ],
  "TelephonyProfileId": "text",
  "TelephonyProfileName": "text",
  "ThingsGroupActive": false,
  "ThingsGroupDescription": "text",
  "ThingsGroupId": "text",
  "ThingsGroupName": "text",
  "Type": "text",
  "MtSmsWebhook": "text",
  "StopMtSmsForWebhook": false,
  "MoVoiceWebhook": "text",
  "MtVoiceWebhook": "text",
  "ExternalGgsnWebhook": "text",
  "CustomerId": "text",
  "RoamingPolicyId": "text",
  "NonIp": false,
  "IMEIPrefix": "text",
  "LockMasterImei": false
}