# Get Device Position History

## Get Device Position History

<mark style="color:blue;">`GET`</mark> `{{baseUrl}}/positions/:deviceId`

**Path Parameters**

| Name     | Required | Description |
| -------- | -------- | ----------- |
| deviceId | true     | Device id   |

**Query Parameters**

| Name      | Required | Description         | Sample value |
| --------- | -------- | ------------------- | ------------ |
| startTime | true     | The start timestamp | 2025-03-01   |
| endTime   | true     | The end timestamp   | 2025-03-05   |

**Response**

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

```javascript
{
    "status": true,
    "message": "Device positions retrieved successfully",
    "data": {
        "deviceId": "67287d2f8faa08541904202b",
        "name": "sample Test",
        "positionsHistory": [
            {
                "latitude": 6.525101289494111,
                "longitude": 3.3821942643294824,
                "course": 61,
                "altitude": 11.2,
                "speed": 51.32,
                "inMotion": false,
                "distance": 20.957101542293742, //in meters
                "transmissionTime": "2025-03-02T18:58:49.992Z",
                "lastRecordedTime": "2025-03-01T21:21:04.919Z"
            },
            {
                "latitude": 6.531294579490574,
                "longitude": 3.3885202424260226,
                "course": 6,
                "altitude": 2,
                "speed": 42.78,
                "inMotion": false,
                "distance": 1.7472167798488925,
                "transmissionTime": "2025-03-03T04:34:35.150Z",
                "lastRecordedTime": "2025-03-03T21:41:26.590Z"
            },
            {
                "latitude": 6.517738332115701,
                "longitude": 3.3853589853420636,
                "course": 288,
                "altitude": 41.6,
                "speed": 42.25,
                "inMotion": false,
                "distance": 8.93223641924388,
                "transmissionTime": "2025-03-03T10:09:17.217Z",
                "lastRecordedTime": "2025-03-01T12:44:36.246Z"
            },
            {
                "latitude": 6.518986308627487,
                "longitude": 3.3848135101302104,
                "course": 354,
                "altitude": 45.7,
                "speed": 66.29,
                "inMotion": true,
                "distance": 11.262399120416255,
                "transmissionTime": "2025-03-03T16:52:52.675Z",
                "lastRecordedTime": "2025-03-02T19:30:42.831Z"
            },
            {
                "latitude": 6.527298254032401,
                "longitude": 3.37184325408705,
                "course": 40,
                "altitude": 15,
                "speed": 33.82,
                "inMotion": true,
                "distance": 7.329908491155209,
                "transmissionTime": "2025-03-03T21:46:40.485Z",
                "lastRecordedTime": "2025-03-01T23:19:28.507Z"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}