Get Device Position History

Get position history for a specific devices

Get Device Position History

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

200: OK Retrieved positions

{
    "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,
                "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,
                "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,
                "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,
                "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,
                "transmissionTime": "2025-03-03T21:46:40.485Z",
                "lastRecordedTime": "2025-03-01T23:19:28.507Z"
            }
        ]
    }
}