How to View Things List?

This guide will show you how you can receive a list of your Things (SIM cards) via an API command. Also you may use various filters to show only specific Things.

To view Things list, please use following request:

curl -X GET "https://console.monogoto.io/things?filterBy%5BThingName%5D=<<<_THING_NAME_>>>&filterBy%5BThingsGroupName%5D=<<<_THING_GROUP_NAME_>>>&filterBy%5BNetworks%5D=<<<_MONOGOTO_NETWORK_NAME_>>>&filterBy%5BActiveMobileSubscriber%5D=<<<_ACTIVE_IMSI_>>>&filterBy%5BIMEI%5D=<<<_IMSI_>>>&filterBy%5BMSISDN%5D=<<<_THING_MSISDN_>>>&filterBy%5BCellId%5D=<<<_CELLID_>>>&filterBy%5BLac%5D=<<<_LAC_>>>&filterBy%5BMnoName%5D=<<<_MNO_NAME_>>>&filterBy%5BExternalUniqueId%5D=<<<_THING_ICCID_>>>&State=<<<_THING_STATE_>>>&filterBy%5BThingDescription%5D=<<<_THING_DESCRIPTION_>>>s&filterBy%5BTags%5D%5B0%5D=<<<_TAG_ID_>>>&filterBy%5BTags%5D%5B1%5D=<<<_TAG_ID_1_>>>&filterBy%5BTags%5D%5B2%5D=<<<_TAG_ID_2_>>>&filterBy%5BTags%5D%5B3%5D=<<<_TAG_ID_3_>>>&sortBy%5BThingName%5D=<<<_THING_NAME_SORT_>>>&limit=<<<_RESULTS_LIMIT_>>> &offset=<<<_RESULTS_OFFSET_>>>" -H "accept: application/json" -H "Authorization: Bearer <<<_TOKEN_HERE_>>>" -H "<<<_CUSTOMER_ID_>>>"

Please note that the above shown command needs to be replaced with information: <<<_THING_NAME_SORT_>>> - replace with how results should be sorted by Thing name (DESC or ASC) DESC – sort results by Thing name in descending order ASC – sort results by Thing name in ascending order <<<_RESULTS_LIMIT_>>> - replace with numerical value showing how many results to display (default – 10, max - 50). To see more results, please use <<<_RESULTS_OFFSET_>>> <<<_RESULTS_OFFSET_>>> - replace with numerical value the offset amount. In short this entered amount will be skipped from the first results. Example: when using 50 in offset you will see results starting with 51-st result. If you do not want to make offset, just write 0 <<<_TOKEN_HERE_>>> - replace with your token. You may obtain Token, by running Login Token API command. <<<_CUSTOMER_ID_>>> - replace with your customer ID. You may obtain Customer ID when running Login Token API command Below you can see list of Filters (not mandatory, thus can be removed or not used in API command, if not necessary): <<<_THING_NAME_>>> - replace with thing name <<<_THING_GROUP_NAME_>>> - replace with Thing Group name <<<_MONOGOTO_NETWORK_NAME_>>> - replace with network you have assigned for your SIM cards to use <<<_ACTIVE_IMSI_>>> - replace with IMSI of a SIM card that was used previously, thus having an assigned IMSI shown in the Thing Menu. Usually, it means that the SIM card is currently in use or was recently in use <<<_IMSI_>>> - replace with IMSI of a SIM card. This SIM does not need to be active <<<_THING_MSISDN_>>> - replace with Thing MSISDN (phone number) <<<_CELLID_>>> - replace with a CellID <<<_LAC_>>> - replace with LAC <<<_MNO_NAME_>>> - replace with MNO (roaming partner/mobile network) name. <<<_THING_ICCID_>>> - replace with your Monogoto Thing ICCID number <<<_THING_STATE_>>> - replace with the Thing state (ACTIVE or SUSPENDED) ACTIVE - SIM card is activated and can be used. SUSPENDED - SIM card is suspended. Can not be used until status is changed to ACTIVE. <<<_THING_DESCRIPTION_>>> - replace with Thing description <<<_THING_TAG_>>> - replace with TAGID that is assigned to this Thing <<<_THING_TAG_1_>>> - replace with additional TAGID that is assigned to this Thing, if necessary <<<_THING_TAG_2_>>> - replace with additional TAGID that is assigned to this Thing, if necessary <<<_THING_TAG_3_>>> - replace with additional TAGID that is assigned to this Thing, if necessary If needed this API can be tested and used in the Monogoto portal following this path: Thing GET /things

Example of request showing 50 Things with 0 offset in descending order by Thing name:

curl -X GET "https://console.monogoto.io/things?sortBy%5BThingName%5D=DESC&limit=50&offset=0" -H "accept: application/json" -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" -H "apikey: cid_ecs1d3a5-f5e62a1-fe8af468wf"

Example of received result:

[
{
"ActivationChargeFlag": false,
"ActiveMobileSubscriber": "123456789101112",
"AddressSignal": "370611111111",
"BatchId": "Tutorial SIM",
"Block": {
"Data": false,
"LTEData": false,
"SMS_MO": false,
"SMS_MO_except_home_country": false,
"SMS_MT": false
},
"CellId": 654321,
"CreatedBy": "UserId_896468g2-5115-4g57-926a-13f0945434c",
"Curr_Latitude": null,
"Curr_Longitude": null,
"CustomerId": "cid_ecs1d3a5-f5e62a1-fe8af468wf",
"Data": 111475219,
"DateAssignedToCustomer": 1596219199006,
"DateCreated": 1596219199008,
"DateModified": 1613145549221,
"DeletionDate": null,
"ExpirationDate": null,
"ExternalBatchId": "Vidas SIM",
"ExternalHLRId": null,
"ExternalUniqueId": "8912372646888991",
"ExternalUniqueType": "ICCID",
"FencingRadius": 0,
"FwBlockAttempts": null,
"GeoDistance": 0,
"IMEI": "86123456789101",
"IPs": [],
"Lac": 123,
"LastAccuracyLocation": {},
"LastLocation": {
"AccuracyInKM": 123.3429066960741,
"IMSI": "123456789101112",
"IsLocationTypeAccurate": false,
"Latitude": 50.169438,
"Longitude": 5.881275,
"MCC": 246,
"MNC": 3,
"MNOId": "MNOId_61486037-6939-4ccb-88be-601101bf8654f",
"Timestamp": 1613030358667,
"Type": "Point"
},
...