Skip to main content
GET
/
api
/
v2
/
vehicles
/
{imei}
/
device-ids
Device ID from IMEI (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/vehicles/{imei}/device-ids \
  --header 'Authorization: Bearer <token>'
{
  "vehicleId": 88421,
  "vehicleName": "Delivery Van 07"
}

​
Overview

Resolves a device IMEI to the legacy vehicle ID and display name for vehicles the caller may access.
The V1 version of this endpoint is Lookup by IMEI.
Rate limit: 60 requests per 60 seconds per token.

​
Endpoint

GET /api/v2/vehicles/{imei}/device-ids

​
Path parameters

​
imei
string
required
Device IMEI (digits only, as stored in Telemax).

​
Response

200 OK — ImeiSearchResultDto
FieldTypeDescription
vehicleIdintegerLegacy vehicle ID
vehicleNamestringVehicle display name

​
Example response

{
  "vehicleId": 88421,
  "vehicleName": "Delivery Van 07"
}

​
Error responses

StatusMeaning
401Vehicle not accessible with the current token
404IMEI not found
curl "https://api.telemax.com.au/api/v2/vehicles/353148090123456/device-ids" \
  -H "Authorization: Bearer <token>"

Authorizations

​
Authorization
string
header
required

JWT Bearer token obtained from POST /api/v2/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 to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).

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

Path Parameters

​
imei
string
required

Response

Successful response