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}}.telematics.guru/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 used 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 or generate an API Key.

To find the organisation ID for your organisation, use the Organisations GraphQL query or call the "GET" method on the following endpoint: https://{{Instance}}/v2/user/organisations

To find the device serial number for your asset, use the Assets GraphQL query or call the "GET" method on the following endpoint: https://{{Instance}}/v3/assets/{{selected organisation id}}. This number is the serial number of the device connected to this asset.
 

Request Parameters

utcDateFrom (string): The start date and time for the telemetry data. (DD-MM-YYYYT00:00:00)

utcDateTo (string): The end date and time for the telemetry data. (DD-MM-YYYYT00:00:00)

offset (integer): The offset for pagination.

limit (integer): The maximum number of data points to be returned.

Result Limit

Each query returns a maximum of 5000 telemetry points. If the requested time range contains more than 5000 points, use the offset and limit parameters to page through the results. After each response, use the returned offset value as the starting point for the next request to retrieve the following set of telemetry points.
 

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:00Z), location coordinates, and speed. The offset indicates the last row ID for pagination or subsequent requests.