# MOVE State

Returns a list of state changes over the given time range.

For the `STATUS` property the possible values are:

* `UNINITIALISED` - initial state
* `READY` -  after initialisation/setup, or after stopAutomaticDetection (in [Android](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/api-interface/android-1/android#stop-automatic-detection), or [iOS](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/api-interface/ios/services#stop-automatic-detection), or [React](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/api-interface/react-native/services#stop-automatic-detection))
* `RUNNING` -  after calling startAutomaticDetection (in [Android](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/api-interface/android-1/android#start-automatic-detection), or [iOS](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/api-interface/ios/services#start-automatic-detection), or [React](https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/api-interface/react-native/services#start-automatic-detection))
* `ERROR` - something on the user device is wrong (e.g. permissions insufficient)

## history

<mark style="color:blue;">`GET`</mark> `https://sdk.dolph.in/state/v1_5/history`

Returns a list of state changes over the given time range.

For the `STATUS` property the possible values are:

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | String |             |

#### Query Parameters

| Name                                         | Type    | Description                                                                                                          |
| -------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| productId<mark style="color:red;">\*</mark>  | Integer |                                                                                                                      |
| contractId<mark style="color:red;">\*</mark> | String  |                                                                                                                      |
| properties                                   | String  | A comma separated list of state properties that shall be returned. At the moment the only possible value is 'STATUS' |
| from                                         | integer | A unix timestamp, start of query range.                                                                              |
| to                                           | integer | A unix timestamp, end of query range.                                                                                |
| limit                                        | integer | Maximum number of items to return, must be greater than or equal to zero.                                            |

{% tabs %}
{% tab title="200: OK " %}

```json
{
  "history": [
    {
      "data": {
        "STATUS": "RUNNING"
      },
      "timestamp": "2022-07-20T05:38:10.586Z"
    },
    {
      "data": {
        "STATUS": "READY"
      },
      "timestamp": "2022-07-20T04:38:10.586Z"
    },
    {
      "data": {
        "STATUS": "UNINITIALISED"
      },
      "timestamp": "2022-07-20T03:38:10.586Z"
    }
  ]
}
```

{% endtab %}
{% endtabs %}