Retrieving Telemetry Data via the Telematics Guru API

A RESTful API request for raw telemetry data for a single asset

Written by Jake Tannenbaum

Updated at May 30th, 2025

Table of Contents

Retrieve Raw Telemetry Data Request URL Request Parameters Response Response Body

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 TG url and observe the responding server name. For example apac03.telematics.guru

To find the organization ID for your organization, you can call the "GET" method on the following endpoint: https://api-qa.telematics.guru/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

utcDateFrom (string): The start date and time for the telemetry data.

utcDateTo (string): The end date and time for the telemetry data.

offset (integer): The offset for pagination.

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

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.

Contact Us