Retrieve Raw Telemetry Data

This RESTful API endpoint retrieves raw telemetry data for a specific asset within a specified time range.

Request URL

GET https://{{Instance}}/v2/{{selected organisation id}}/asset/{{selected serial id}}/rawtelemetry

To find your instance, you can perform a ping test to see the underlying server name that responds. A free tool that can be users for this purpose if you are unfamiliar is PING Test by WebSitePulse. Simply enter your Telematics Guru URL and observe the responding server name. For example: mycompany.guru might return apac03.telematics.guru

To obtain a bearer token you will need to authenticate yourself. 

To find the organization ID for your organization, you can call the "GET" method on the following endpoint: https://{{Instance}}/v2/user/organisations

To find the serial number for your asset, you can call the "GET" method on the following endpoint: https://{{Instance}}/v3/assets/{{selected organisation id}}

Request Parameters

Response

The response is in JSON format with a status code of 200. It includes an array of telemetry containing raw telemetry data for the specified asset.

Response Body

{  "assetName": "",
   "serial": "",
   "telemetry": 
    [    
    	{      
    	"dateTimeUtcRaw": 0,
    	"latitudeRaw": 0,
    	"longitudeRaw": 0,
    	"speedKmH": 0    
        }
    ]
}

The telemetry array contains raw telemetry data including date/time in UTC format (YYYY-MM-DDT00:00:00), location coordinates, and speed. The offset indicates the last row ID for pagination or subsequent requests.