Vehicle info

Vehicle info (V2)

curl --request GET \
  --url https://api.telemax.com.au/v2/api/vehicles/info \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.telemax.com.au/v2/api/vehicles/info', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.telemax.com.au/v2/api/vehicles/info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.telemax.com.au/v2/api/vehicles/info"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.telemax.com.au/v2/api/vehicles/info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "label": "VIN",
    "value": "MPAUCS40GST011254"
  },
  {
    "label": "Vehicle ID",
    "value": "28193"
  },
  {
    "label": "Make",
    "value": "Isuzu"
  },
  {
    "label": "Model",
    "value": "MU-X"
  },
  {
    "label": "Model Year",
    "value": "2025"
  },
  {
    "label": "Product Type",
    "value": "Car"
  },
  {
    "label": "Body",
    "value": "Wagon"
  },
  {
    "label": "Drive",
    "value": "Rear-wheel drive"
  },
  {
    "label": "Engine Displacement (ccm)",
    "value": "2999"
  },
  {
    "label": "Engine Power (kW)",
    "value": "140"
  },
  {
    "label": "Engine Power (HP)",
    "value": "188"
  },
  {
    "label": "Fuel Type - Primary",
    "value": "Diesel"
  },
  {
    "label": "Engine Code",
    "value": "4JJ3-TCX"
  },
  {
    "label": "Transmission",
    "value": "Auto"
  },
  {
    "label": "Number of Gears",
    "value": "6"
  },
  {
    "label": "Manufacturer",
    "value": "Isuzu Motors Company (Thailand) Limited"
  },
  {
    "label": "Manufacturer Address",
    "value": "38 Moo 9 Poojaosamingprai Road, ..."
  },
  {
    "label": "Plant Country",
    "value": "Thailand"
  },
  {
    "label": "Make Logo",
    "value": "https://cdn.example.com/img/make/isuzu.svg"
  },
  {
    "label": "Engine Compression Ratio",
    "value": "16.3"
  },
  {
    "label": "Engine Cylinder Bore (mm)",
    "value": "95.4"
  },
  {
    "label": "Engine Cylinders",
    "value": "4"
  },
  {
    "label": "Engine Cylinders Position",
    "value": "Inline"
  },
  {
    "label": "Engine Position",
    "value": "Front, Longitudinal"
  },
  {
    "label": "Engine RPM",
    "value": "3600"
  },
  {
    "label": "Engine Stroke (mm)",
    "value": "104.9"
  },
  {
    "label": "Engine Torque (RPM)",
    "value": "450"
  },
  {
    "label": "Engine Turbine",
    "value": "Turbocharger, Intercooler"
  },
  {
    "label": "Valve Train",
    "value": "DOHC"
  },
  {
    "label": "Fuel Capacity (l)",
    "value": "80"
  },
  {
    "label": "Fuel System",
    "value": "Diesel Commonrail"
  },
  {
    "label": "Valves per Cylinder",
    "value": "4"
  },
  {
    "label": "Number of Axles",
    "value": "2"
  },
  {
    "label": "Number of Doors",
    "value": "5"
  },
  {
    "label": "Number of Seats",
    "value": "7"
  },
  {
    "label": "Power Steering",
    "value": "Electric Steering"
  },
  {
    "label": "Steering Type",
    "value": "Steering rack and pinion"
  },
  {
    "label": "Wheelbase (mm)",
    "value": "2855"
  },
  {
    "label": "Width (mm)",
    "value": "1870"
  },
  {
    "label": "Ride Height (mm)",
    "value": "235"
  },
  {
    "label": "Track Front (mm)",
    "value": "1570"
  },
  {
    "label": "Track Rear (mm)",
    "value": "1570"
  },
  {
    "label": "Weight Empty (kg)",
    "value": "2800"
  },
  {
    "label": "ABS",
    "value": "1"
  },
  {
    "label": "Check Digit",
    "value": "G"
  },
  {
    "label": "Sequential Number",
    "value": "011254"
  },
  {
    "label": "Body Type",
    "value": "Suv"
  },
  {
    "label": "Fuel Type",
    "value": "Diesel"
  },
  {
    "label": "Engine Size",
    "value": "3"
  },
  {
    "label": "Colour",
    "value": "White"
  },
  {
    "label": "Fuel Capacity",
    "value": "80"
  },
  {
    "label": "Number Plate",
    "value": "ABC123"
  },
  {
    "label": "Registration State",
    "value": "Queensland"
  },
  {
    "label": "Registration Country",
    "value": "Australia"
  }
]

GET

api

vehicles

info

Vehicle info (V2)

curl --request GET \
  --url https://api.telemax.com.au/v2/api/vehicles/info \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.telemax.com.au/v2/api/vehicles/info', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.telemax.com.au/v2/api/vehicles/info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.telemax.com.au/v2/api/vehicles/info"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.telemax.com.au/v2/api/vehicles/info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "label": "VIN",
    "value": "MPAUCS40GST011254"
  },
  {
    "label": "Vehicle ID",
    "value": "28193"
  },
  {
    "label": "Make",
    "value": "Isuzu"
  },
  {
    "label": "Model",
    "value": "MU-X"
  },
  {
    "label": "Model Year",
    "value": "2025"
  },
  {
    "label": "Product Type",
    "value": "Car"
  },
  {
    "label": "Body",
    "value": "Wagon"
  },
  {
    "label": "Drive",
    "value": "Rear-wheel drive"
  },
  {
    "label": "Engine Displacement (ccm)",
    "value": "2999"
  },
  {
    "label": "Engine Power (kW)",
    "value": "140"
  },
  {
    "label": "Engine Power (HP)",
    "value": "188"
  },
  {
    "label": "Fuel Type - Primary",
    "value": "Diesel"
  },
  {
    "label": "Engine Code",
    "value": "4JJ3-TCX"
  },
  {
    "label": "Transmission",
    "value": "Auto"
  },
  {
    "label": "Number of Gears",
    "value": "6"
  },
  {
    "label": "Manufacturer",
    "value": "Isuzu Motors Company (Thailand) Limited"
  },
  {
    "label": "Manufacturer Address",
    "value": "38 Moo 9 Poojaosamingprai Road, ..."
  },
  {
    "label": "Plant Country",
    "value": "Thailand"
  },
  {
    "label": "Make Logo",
    "value": "https://cdn.example.com/img/make/isuzu.svg"
  },
  {
    "label": "Engine Compression Ratio",
    "value": "16.3"
  },
  {
    "label": "Engine Cylinder Bore (mm)",
    "value": "95.4"
  },
  {
    "label": "Engine Cylinders",
    "value": "4"
  },
  {
    "label": "Engine Cylinders Position",
    "value": "Inline"
  },
  {
    "label": "Engine Position",
    "value": "Front, Longitudinal"
  },
  {
    "label": "Engine RPM",
    "value": "3600"
  },
  {
    "label": "Engine Stroke (mm)",
    "value": "104.9"
  },
  {
    "label": "Engine Torque (RPM)",
    "value": "450"
  },
  {
    "label": "Engine Turbine",
    "value": "Turbocharger, Intercooler"
  },
  {
    "label": "Valve Train",
    "value": "DOHC"
  },
  {
    "label": "Fuel Capacity (l)",
    "value": "80"
  },
  {
    "label": "Fuel System",
    "value": "Diesel Commonrail"
  },
  {
    "label": "Valves per Cylinder",
    "value": "4"
  },
  {
    "label": "Number of Axles",
    "value": "2"
  },
  {
    "label": "Number of Doors",
    "value": "5"
  },
  {
    "label": "Number of Seats",
    "value": "7"
  },
  {
    "label": "Power Steering",
    "value": "Electric Steering"
  },
  {
    "label": "Steering Type",
    "value": "Steering rack and pinion"
  },
  {
    "label": "Wheelbase (mm)",
    "value": "2855"
  },
  {
    "label": "Width (mm)",
    "value": "1870"
  },
  {
    "label": "Ride Height (mm)",
    "value": "235"
  },
  {
    "label": "Track Front (mm)",
    "value": "1570"
  },
  {
    "label": "Track Rear (mm)",
    "value": "1570"
  },
  {
    "label": "Weight Empty (kg)",
    "value": "2800"
  },
  {
    "label": "ABS",
    "value": "1"
  },
  {
    "label": "Check Digit",
    "value": "G"
  },
  {
    "label": "Sequential Number",
    "value": "011254"
  },
  {
    "label": "Body Type",
    "value": "Suv"
  },
  {
    "label": "Fuel Type",
    "value": "Diesel"
  },
  {
    "label": "Engine Size",
    "value": "3"
  },
  {
    "label": "Colour",
    "value": "White"
  },
  {
    "label": "Fuel Capacity",
    "value": "80"
  },
  {
    "label": "Number Plate",
    "value": "ABC123"
  },
  {
    "label": "Registration State",
    "value": "Queensland"
  },
  {
    "label": "Registration Country",
    "value": "Australia"
  }
]

Overview

Returns decoded vehicle information for a single vehicle, looked up by IMEI, vehicle ID, or VIN. Exactly one of the three query parameters must be supplied; otherwise the call returns 422. The response is a flat list of { label, value } pairs, so all available fields are returned without a fixed schema. Common fields include make, model, engine specs, body dimensions, and manufacturer details. This is a new V2-only endpoint with no V1 equivalent.

Rate limit: 144,000 req/s · 60/min · 144,000/hr · 144,000/day — in practice 60 requests per minute per API key

Endpoint

GET /v2/api/vehicles/info

Query parameters

Exactly one of the following must be provided:

string

Tracker IMEI, matched exactly (trimmed). The lookup is not limited to your companies: if more than one vehicle carries this IMEI, one is picked arbitrarily, and the call returns 404 if that vehicle is not one of yours or has no public ID.

integer

Public vehicle ID (deviceId).

string

Vehicle Identification Number, matched trimmed and case-insensitively among your companies’ vehicles. If several share the VIN, an arbitrary one is returned.

Response

200 OK — VinDecodeItemDto[] A flat list of label/value pairs. The set of labels returned depends on what has been decoded for the vehicle. The response is [] (an empty array) when the VIN has not been decoded; nothing from the vehicle record appears then either. When a decode exists, these labels are taken from the vehicle record whenever the record has a value: Make, Model, Model Year, Body Type, Fuel Type, Transmission, Engine Size, Number of Doors, Colour, Fuel Capacity, Battery Capacity, Number Plate, Registration State, Registration Country. Each one replaces a decoded value with the same label, or is appended. Fuel Type, Body Type and Transmission are identifiers such as Petrol, Diesel, HybridElectric, Suv, PickupTruck, Auto or Manual. Because Fuel Type comes from the vehicle record, it can disagree with a decoded label such as Fuel Type - Primary.

Field	Type	Description
label	string	Field name (e.g. `"Make"`, `"Model Year"`, `"Engine Power (kW)"`)
value	string	Field value (always a string, even for numeric or array values)

Common labels

The set of labels returned depends on what has been decoded for that VIN. Below are labels observed from actual API responses, plus the vehicle-record labels listed above (Body Type, Engine Size and Number Plate rows are illustrative):

Label	Example value
VIN	`"MPBCMFF70RX582825"`
Vehicle ID	`"1647"`
Make	`"Ford"`
Make ID	`"30"`
Model	`"Ranger"`
Model Year	`"2024"`
Product Type	`"Car"`
Body	`"Pickup"`
Body Type	`"PickupTruck"`
Engine Displacement (ccm)	`"2993"`
Engine Power (kW)	`"184"`
Engine Power (HP)	`"247"`
Fuel Type - Primary	`"Diesel"`
Fuel Type	`"Petrol"`
Transmission	`"Auto"`
Number of Gears	`"10"`
Engine Size	`"3"`
Manufacturer	`"Ford Motor Company (Thailand) Limited"`
Manufacturer Address	`"33/19 Moo 6, Bo-win Sub District, Sriracha Dist Chonburl"`
Plant Country	`"Thailand"`
Make Logo	`"https://cdn.example.com/img/make/ford.svg"`
Fuel Consumption Combined (l/100km)	`"8.4"`
Fuel Consumption Extra Urban (l/100km)	`"7.5"`
Fuel Consumption Urban (l/100km)	`"10"`
Number of Axles	`"2"`
Number of Seats	`"5"`
Weight Empty (kg)	`"3350"`
Check Digit	`"0"`
Sequential Number	`"582825"`
Number of Doors	`"4"`
Colour	`"Gunmetal"`
Fuel Capacity	`"80"`
Battery Capacity	`"0"`
Number Plate	`"ABC123"`
Registration State	`"New South Wales"`
Registration Country	`"Australia"`

Not all labels will be present for every vehicle — availability depends on what data is on record for that VIN.

Example response

[
  { "label": "VIN", "value": "MPBCMFF70RX582825" },
  { "label": "Vehicle ID", "value": "1647" },
  { "label": "Make", "value": "Ford" },
  { "label": "Make ID", "value": "30" },
  { "label": "Model", "value": "Ranger" },
  { "label": "Model Year", "value": "2024" },
  { "label": "Product Type", "value": "Car" },
  { "label": "Body", "value": "Pickup" },
  { "label": "Engine Displacement (ccm)", "value": "2993" },
  { "label": "Engine Power (kW)", "value": "184" },
  { "label": "Fuel Type - Primary", "value": "Diesel" },
  { "label": "Transmission", "value": "Auto" },
  { "label": "Fuel Capacity", "value": "80" },
  { "label": "Colour", "value": "Gunmetal" },
  { "label": "Registration State", "value": "New South Wales" },
  { "label": "Registration Country", "value": "Australia" }
]

Error responses

Status	Meaning
401	Missing, invalid or expired bearer token (`INVALID_CREDENTIALS`)
403	The API key lacks this endpoint’s permission (`INVALID_SCOPE`), or the company is suspended (`CompanySuspended`) — see 403 Forbidden
404	Vehicle not found, or not in your companies, or the vehicle has no VIN (see `imei` above for the unscoped IMEI lookup)
422	Not exactly one of `imei`, `id` and `vin` was supplied: “Exactly one of imei, id, or vin must be provided.”

curl "https://api.telemax.com.au/v2/api/vehicles/info?imei=353148090123456" \
  -H "Authorization: Bearer <token>"

Authorizations

Authorization

string

header

required

JWT Bearer token obtained from POST /v2/api/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping: API key tokens are scoped by the key's company and its action set; see Token scoping.

No refresh endpoint — re-authenticate with your API key when the token expires.

Query Parameters

imei

string

integer

vin

string

Response

Successful response

label

string

Field name (e.g. "Make", "Model Year", "Engine Power (kW)")

value

string

Field value (always a string, even for numeric or array values)

Getting Started

Guides

Authentication

Companies & fleet

Vehicles

Vehicle commands

Alerts

Telemetry & replay

Insights & diagnostics

Webhooks

Reference

Overview

Endpoint

Query parameters

Response

Common labels

Example response

Error responses

Authorizations

Query Parameters

Response

​Overview

​Endpoint

​Query parameters

​Response

​Common labels

​Example response

​Error responses

Authorizations

Query Parameters

Response

Overview

Endpoint

Query parameters

Response

Common labels

Example response

Error responses