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
}

Error while loading OpenAPI operation — Failed to convert Swagger 2.0 to OpenAPI 3.1.1