Get Thing State

This guide will show you how you can check your Thing state via API and the meaning of each state.

Get Thing State

GET https://console.monogoto.io/thing/ThingId_ICCID_{ICCID}/state/

Possible values: PROVISIONED, TEST_ACTIVE, SUSPENDED, ACTIVE, RETIRED

Path Parameters

Name	Type	Description
ICCID*	String	The ICCID of your SIM

Headers

Name	Type	Description
YOUR_TOKEN*	String	Your authentication token

200: OK OK

{
    ACTIVE
}

401: Unauthorized Unauthorized

{
    // Response
}

404: Not Found Not found

{
    // Response
}

500: Internal Server Error Internal Server Error

{
    // Response
}

Before you run API to view Thing state, below you can find a short explanation on Thing states:

• ACTIVE: SIM card is activated and can be used.

• SUSPENDED: SIM card is suspended and cannot be used until status is changed to ACTIVE.

• PROVISIONED: SIM card is only provisioned, but was not activated to be used

Example using cURL:

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

Example of response to our request:

{
    ACTIVE
}

Get unassigned things (not assigned to Things Group)

GEThttps://console.monogoto.io/thing/{ThingId}/state/

Path parameters

ThingId*string

Thing ID

Response

200401404500

Thing current state

Body

application/json

stateenum

State of Thing

PROVISIONEDTEST_ACTIVESUSPENDEDACTIVERETIRED

Request

JavaScriptCurlPython

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

Response

200401404500

{
  "state": "PROVISIONED"
}