Back to Monogoto website

Get Things List

This guide will show you how you can receive a list of your Things (SIM cards) via an API command

Returns list of things

GET https://console.monogoto.io/things

Path Parameters

Name
Type
Description

THING_NAME_SORT

String

Headers

Name
Type
Description

YOUR_TOKEN*

String

Your authentication token

[
  {
    "Type": "string",
    "PricePlanInnerId": "string",
    "ThingId": "string",
    "CustomerId": "string",
    "ThingName": "string",
    "ThingDescription": "string",
    "ThingsGroupId": "string",
    "ExternalUniqueId": "string",
    "ExternalUniqueType": "string",
    "ExternalBatchId": "string",
    "BatchId": "string",
    "SubProfId": "string",
    "NetworkProviderId": "string",
    "RoamingPolicyId": "string",
    "GeoDistance": 0,
    "ThingTag": [
      "string"
    ],
    "Latitude": 0,
    "Longitude": 0,
    "FencingRadius": 0,
    "UnavailabilityTime": "2022-05-30T10:00:20.823Z",
    "IPv4": "string",
    "IPv4PoolId": "string",
    "IPv4AllocationPolicy": "string",
    "IPv4Lock": true,
    "IPv6": "string",
    "IPv6PoolId": "string",
    "IPv6AllocationPolicy": "string",
    "IPv6Lock": true,
    "FwBlockAttempts": 0,
    "StreetAddress": "string",
    "Remarks": "string",
    "hss": {
      "serviceSelection": "string",
      "pdnType": 0,
      "vplmnDynamicAddressAllowed": 0,
      "PDNgwAllocationType": 0,
      "ambr": {
        "maxRequestedBandwidthUL": 0,
        "maxRequestedBandwidthDL": 0
      },
      "epsQos": {
        "qosClassIden": 0,
        "priorityLevel": 0,
        "preemptionCapability": 0,
        "preemptionVulnerability": 0
      }
    },
    "State": "string",
    "BillingState": "string",
    "DateCreated": 0,
    "DateModified": 0,
    "DateAssignedToCustomer": 0,
    "IMEI": "string",
    "MasterIMEI": "string",
    "LockMasterImei": true,
    "IMSI": "string",
    "MSISDN": "string",
    "VcsAccountId": "string",
    "LastLocation": {
      "Timestamp": 0,
      "Type": "string",
      "Latitude": 0,
      "MCC": "string",
      "MNC": "string",
      "Longitude": 0,
      "AccuracyInKM": 0,
      "IMSI": "string",
      "IsLocationTypeAccurate": true,
      "CellId": 0,
      "Lac": 0
    },
    "LastAccuracyLocation": {
      "Timestamp": 0,
      "Type": "string",
      "Latitude": 0,
      "MCC": "string",
      "MNC": "string",
      "Longitude": 0,
      "AccuracyInKM": 0,
      "IMSI": "string",
      "IsLocationTypeAccurate": true,
      "CellId": 0,
      "Lac": 0
    },
    "RoamingRestrictions": [
      {
        "BlockRoaming": true,
        "BlockSMS": true,
        "BlockMOVoiceFlag": true,
        "BlockMTVoiceFlag": true,
        "DataRestrictionByterateLimit": "string",
        "MNOId": "string",
        "Preferred": true,
        "RoamingPartnerId": 0,
        "RoamingPlanId": "string",
        "ByterateFlag": true,
        "BlockMOSMSFlag": true
      }
    ],
    "Block": {
      "Data2G": true,
      "Data": true,
      "LTEData": true,
      "Data5G": true,
      "SMS_MO": true,
      "SMS_MT": true,
      "Supplementary_Services": true,
      "Voice_International": true,
      "Voice_International_Exc_Home": true,
      "Voice_MO": true,
      "Voice_MT": true,
      "Voice_Premium": true
    },
    "ActualUsage": {
      "MO_SMS_CDR_": 0,
      "Data_": 0,
      "Voice_": 0,
      "Alarm": 0
    },
    "APN": {
      "ShortId": "string",
      "DateModified": "string",
      "Name": "string",
      "ApnId": "string",
      "Description": "string",
      "IpRange": "string",
      "Ipv6Range": "string",
      "Type": "string",
      "InterfaceName": "string",
      "ServedByJpU": true,
      "DynamicIPAddress": true,
      "pdpsub": {
        "Delay-Class": 0,
        "Mean-Throughput": 0,
        "Pdp-ContextId": 0,
        "Peak-Throughput": 0,
        "Precedence-Class": 0,
        "Reliability-Class": 0,
        "PreferredDataMode": 0,
        "NonIpDataDelvMechanism": 0,
        "NonIPPDNTypeIndicator": 0,
        "qos": {
          "Delivery-Of-Erroneous-SDU": 0,
          "Delivery-Order": 0,
          "Guaranteed-Bit-Rate-For-DownLink": 0,
          "Guaranteed-Bit-Rate-For-Uplink": 0,
          "Guaranteed-Bit-Rate-ForDownlink(extended)": 0,
          "Maximum-Bit-Rate-For-Downlink": 0,
          "Maximum-Bit-Rate-For-Downlink(extended)": 0,
          "Maximum-Bit-Rate-For-Uplink": 0,
          "Maximum-SDU-Size": 0,
          "Priority": 0,
          "Residual-BER": 0,
          "SDU-Error-Ratio": 0,
          "Signaling-Indication": 0,
          "Source-Statistics-Descriptor": 0,
          "Traffic-Class": 0,
          "Traffic-Handling-Priority": 0,
          "Transfer-Delay": 0
        }
      }
    },
    "cas": "string"
  }
]

Example using cURL:

curl -X GET \
     --url "https://console.monogoto.io/things/" \
     -H "accept: application/json" \
     -H "Authorization: Bearer {YOUR_TOKEN}"

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"
    },
  
...

Filters

You may use various filters to show only specific Things. Example:

curl -X GET \
    --url "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 {YOUR_TOKEN}"

Variables:

  • {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

  • {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

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

curl -X GET \
    --url "https://console.monogoto.io/things?sortBy%5BThingName%5D=DESC&limit=50&offset=0" 
    -H "accept: application/json" 
    -H "Authorization: Bearer {YOUR_TOKEN}"

PreviousThingsNextGet Thing Information

Last updated